JSend-Fehlerformat
Fehlgeschlagene API-Aufrufe liefern status error, message, code und data im JSend-Format. Lesen Sie immer message und code. Häufige Ursachen: fehlender API-Zugang, abgelaufenes JWT, ungültige Nummern.
Beispiel-Fehlerantwort
Beispiel-Validierungsfehler bei fehlendem Pflichtfeld.
curl -X POST 'https://app.buzzbip.com/api/contacts/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"firstname": "Jane"}'Debugging-Checkliste
Authorization-Format prüfen (Bearer mit Leerzeichen). Trailing Slashes prüfen. hasApiAccess aktiv? status, message, data gemeinsam loggen. Zuerst GET /api/contacts/ testen.
Vollständigen JSend-Body bei Fehlern protokollieren — die Nachricht ist der schnellste Hinweis.
Integrationshinweise
Bei der Integration dieses Buzzbip-Endpunkts https://app.buzzbip.com als Produktionshost verwenden. JWT über POST /api/login_check holen und Authorization: Bearer mitsenden. User.hasApiAccess im Buzzbip-Admin muss aktiv sein. JSend-Antworten (status, message, data) auswerten. Für E-Commerce-Plugins zusätzlich x-api-key, x-platform-type und x-base-uri senden. Abschließende Slashes bei POST /api/contacts/ und POST /api/whatsapp/ beachten. Bei Ratenlimits Backoff-Retries implementieren. Zugangsdaten serverseitig speichern und vor JWT-Ablauf (3600 s) neu authentifizieren.
Sicherheit
Sicherheit: Zugangsdaten nur serverseitig, TLS Pflicht, fehlgeschlagene Auth überwachen. Staging- und Produktionskonten trennen. Vorlagen und Automationen dokumentieren. Nummern und Inhalte in geteilten Logs schwärzen.
Wie geht es weiter?
Zurück zu API-Ressourcen: api/contacts getting-started/authentication api/secret-key