API-Authentifizierung

Die Spark!-API verwendet API-Schlüssel zur Authentifizierung. Füge deinen API-Schlüssel im Authorization-Header jeder Anfrage ein.

1. Navigiere zu Settings → API → API Keys
2. Klicke auf "Create API Key"
3. Benenne deinen Schlüssel (z. B. "Production", "Staging")
4. Lege Berechtigungen fest (nur Lesen oder Lesen und Schreiben)
5. Kopiere den Schlüssel und bewahre ihn sicher auf

Füge den API-Schlüssel im Authorization-Header ein:

Authorization: Bearer YOUR_API_KEY

API-Anfragen unterliegen folgenden Limits:

• Standard – 100 Anfragen pro Minute
• Massenoperationen – 10 Anfragen pro Minute
• Webhooks – unbegrenzt (ausgehend)

Jede Antwort enthält Header mit den Anfragelimits:

• X-RateLimit-Limit – maximal zulässige Anfragen
• X-RateLimit-Remaining – verbleibende Anfragen
• X-RateLimit-Reset – Unix-Zeitstempel der Rücksetzung des Limits

API-Fehler liefern standardmäßige HTTP-Statuscodes:

• 400 – ungültige Anfrage (ungültige Parameter)
• 401 – nicht autorisiert (ungültiger oder fehlender API-Schlüssel)
• 403 – verboten (unzureichende Berechtigungen)
• 404 – nicht gefunden
• 429 – zu viele Anfragen (Anfragelimit erreicht)
• 500 – Serverfehler

• Produktion – https://api.chargezen.com/spark/v1
• Sandbox – https://sandbox.chargezen.com/spark/v1