Über die REST-API von LocalUp können Ihre Entwickler andere Systeme — ein CRM, ein BI-Tool, Ihre Website — mit Ihren Daten verbinden: Standorte, Bewertungen und mehr. Auf dem Bildschirm API erstellen Sie API-Schlüssel, abonnieren Webhooks, verfolgen Anfrageprotokolle und öffnen die API-Referenz.
Sie öffnen ihn über die Seitenleiste: Sonstiges → API. Sehen Sie den Menüpunkt nicht, ist der API-Zugriff für Ihr Konto nicht aktiviert — fragen Sie Ihren Kundenbetreuer. Meldet der Bildschirm, dass Sie keinen Zugriff haben, erlaubt Ihre Rolle nicht die Verwaltung von API-Schlüsseln.
Schnellstart
Der Block Schnellstart zeigt eine Beispielanfrage. Alle Endpunkte liegen unter /api/v1 auf Ihrer Cabinet-Adresse, und jede Anfrage enthält einen API-Schlüssel im Header Authorization:
curl https://<your cabinet address>/api/v1/locations \
-H "Authorization: Bearer <your API key>"
Jede Anfrage ist auf die Daten Ihres Kontos beschränkt.
API-Schlüssel
Die Tabelle API-Schlüssel listet Ihre Schlüssel mit ihren Berechtigungen, ihrem Status (active oder revoked) sowie den Daten Erstellt und Zuletzt verwendet.
- Schlüssel erstellen — erstellt einen Schlüssel mit einem Namen und den Berechtigungen, die er nutzen darf. Siehe Einen API-Schlüssel erstellen.
- Rotieren — stellt ein neues Token für den Schlüssel aus; das aktuelle Token funktioniert sofort nicht mehr.
- Widerrufen — deaktiviert den Schlüssel; Aufrufe damit schlagen sofort fehl. Dies lässt sich nicht rückgängig machen.
Webhooks
Mit Webhooks benachrichtigt LocalUp Ihr System, wenn etwas passiert, statt dass Ihr System wiederholt nachfragen muss. Klicken Sie auf Neuer Webhook, geben Sie einen Namen, die URL, die die Ereignisse empfangen soll, und die zu abonnierenden Ereignisse ein und klicken Sie dann auf Webhook erstellen.
LocalUp sendet dann bei jedem ausgewählten Ereignis eine signierte POST-Anfrage an Ihre URL. Nach dem Erstellen sehen Sie das Signaturgeheimnis einmalig — speichern Sie es und prüfen Sie damit, dass Anfragen wirklich von LocalUp stammen.
In der Tabelle können Sie mit Test senden ein Testereignis in die Warteschlange stellen, das Ergebnis der Letzten Zustellung (OK oder Fehlgeschlagen) prüfen und ein Abonnement löschen.
Anfrageprotokolle
Anfrageprotokolle · letzte 30 Tage listet die mit Ihren Schlüsseln gemachten API-Aufrufe: Zeit, Methode, Pfad, Status, Dauer und Schlüssel. Filtern Sie nach Antwortstatus, um fehlschlagende Aufrufe zu finden; mit der Aktualisieren-Schaltfläche aktualisieren Sie die Liste.
API-Referenz
Klicken Sie auf API-Referenz (oben rechts), um die vollständige Dokumentation der für Ihre Schlüssel verfügbaren Endpunkte zu öffnen: Basis-URL, Authentifizierung, Ratenlimits, die von jedem Endpunkt benötigten Berechtigungen, Parameter, Anfrage- und Antwortschemas sowie Beispiele. OpenAPI herunterladen speichert die maschinenlesbare Spezifikation für Codegeneratoren und API-Tools.
Jeder Schlüssel hat ein Limit für Anfragen pro Minute, das er mit dem MCP-Server teilt. Wird das Limit überschritten, antwortet die API mit 429 und einem Header Retry-After. Das genaue Limit steht in der API-Referenz.