Erste Schritte
Basis-URL, Authentifizierung, Mandantenzuordnung und Rate Limits.
Überblick
Die öffentliche Exportlab-API verbindet vor allem HR-, CRM- oder ERP-Systeme mit Group-Shoot-Galerien. Sie kann Teilnehmer importieren und auflisten, zugeordnete Bilder abrufen und eigene Check-in-Oberflächen versorgen.
Basis-URL
URL
https://api.exportlab.io/v1Authentifizierung
- Erstelle den Schlüssel unter Einstellungen → Integrationen → API Keys und kopiere ihn sofort.
- Server-Endpunkte benötigen Authorization: Bearer <API_KEY> oder X-Api-Key sowie X-Tenant-Slug.
- API-Schlüssel gehören ausschließlich in serverseitigen Code und werden nach dem Erstellen nur einmal angezeigt.
- Das Limit beträgt 60 Anfragen pro Minute und API-Schlüssel. Nutze X-RateLimit-Reset nach einer 429-Antwort.
- Die öffentlichen Endpunkte GET /group-shoot/checkin/{token} und POST /group-shoot benötigen keinen API-Schlüssel, aber einen gültigen X-Tenant-Slug.
- Die serverseitigen Group-Shoot-Endpunkte sind ab Creator verfügbar.
Beispiel
cURL
curl "https://api.exportlab.io/v1/group-shoot/checkin/{TOKEN}/persons" \
+ -H "Authorization: Bearer YOUR_API_KEY" \
+ -H "X-Tenant-Slug: YOUR_TENANT"Antworten und Fehler
- Alle Antworten sind JSON. Bewahre requestId beziehungsweise den Header X-Request-Id für eine Supportanfrage auf.
- 400 weist meist auf fehlende oder ungültige Eingaben hin, 401 auf den API-Schlüssel, 403 auf den Plan, 404 auf Token oder Datensatz, 409 auf eine erreichte Kapazität und 429 auf das Rate Limit.
- API-Schlüssel sind mandantenbezogen; OAuth beziehungsweise benutzerdelegierte Autorisierung wird nicht angeboten.
War diese Seite hilfreich?
Dein Feedback verbessert diese Anleitung.