Übersicht
Nach dem JWT testen Sie die Verbindung mit einer einfachen authentifizierten GET-Anfrage. Die Kontaktliste ist ein guter Smoke-Test. Nutzen Sie https://app.buzzbip.com und den abschließenden Slash bei POST.
Beispielanfrage
Erste Kontaktseite mit Standard-Paginierung abrufen.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'Antwort interpretieren
Erfolgreiche JSend-Antwort: status success, message und data. Fehler: status error mit message, code, data. Immer JSON prüfen, nicht nur HTTP-Status.
Protokollieren Sie vollständige JSend-Bodies während der Integrationstests.
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?
Kontakte und Messaging erkunden: api/contacts api/whatsapp-messaging getting-started/errors
