REST-API und API-Schlüssel (Integrationen)
Integrieren Sie das CRM mit anderen Systemen über eine REST-API, authentifiziert per Schlüssel.
Sellio stellt eine REST-API bereit, mit der Sie Datensätze aus anderen Systemen (Zapier, Make, eigene Skripte usw.) lesen und schreiben können. Der Zugriff wird über einen API-Schlüssel authentifiziert, den Sie unter Einstellungen → API und Schlüssel erzeugen.
Einen Schlüssel erzeugen
- Gehen Sie zu Einstellungen → API und Schlüssel.
- Geben Sie ihm einen Namen (z. B. „Zapier-Integration“) und klicken Sie auf „Schlüssel erzeugen“.
- Kopieren Sie den Schlüssel SOFORT: Er wird nur einmal angezeigt und kann danach nicht wiederhergestellt werden.
- Um eine Integration abzuschalten, verwenden Sie „Widerrufen“, und der Schlüssel funktioniert sofort nicht mehr.
Endpunkte
- GET /api/v1/{object}: listet Datensätze auf (Parameter: limit, offset, search).
- GET /api/v1/{object}/{id}: ein einzelner Datensatz.
- POST /api/v1/{object}: erstellt einen Datensatz (JSON-Body mit den Feldern).
- PATCH /api/v1/{object}/{id}: aktualisiert Felder eines Datensatzes.
Senden Sie den Schlüssel im Header Authorization: Bearer sk_live_… Das {object} ist der API-Name des Objekts (contact, company, lead, opportunity oder eines Ihrer eigenen Objekte).
Ratenlimit und Nutzung (SLA)
Jeder Schlüssel hat ein Limit von Anfragen pro Minute (Standard 120), das in der Schlüsselliste selbst angepasst werden kann. Jede Antwort enthält die Header X-RateLimit-Limit (die Obergrenze), X-RateLimit-Remaining (wie viele im aktuellen Fenster noch verbleiben) und X-RateLimit-Reset (den Zeitpunkt, als Epoch, an dem sich das Fenster zurücksetzt).
Überschreiten Sie das Limit, antwortet die API mit 429 (Too Many Requests) und dem Header Retry-After, der angibt, wie viele Sekunden Sie warten sollen, bevor Sie es erneut versuchen. Der Schlüsselbildschirm zeigt zudem die Gesamtzahl der bereits von jedem Schlüssel getätigten Anfragen (Nutzungsmetrik).