Panoramica
Dopo aver ottenuto un JWT, verifica la connettività con una semplice GET autenticata. L'elenco contatti è un buon smoke test. Usa https://app.buzzbip.com e lo slash finale su alcuni POST.
Esempio di richiesta
Elenca la prima pagina di contatti con paginazione predefinita.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'Interpretare la risposta
Una risposta JSend riuscita ha status success, message e data. Gli errori usano status error con message, code e data. Controlla sempre il JSON, non solo HTTP.
Registra i corpi JSend completi durante i test di integrazione.
Note di integrazione
Integrando questo endpoint Buzzbip, usa https://app.buzzbip.com come host di produzione. Ottieni un JWT da POST /api/login_check e invia Authorization: Bearer su ogni richiesta. Verifica che User.hasApiAccess sia abilitato nell'admin Buzzbip. Analizza le risposte JSend (status, message, data). Per i plugin e-commerce, invia anche x-api-key, x-platform-type e x-base-uri. Rispetta gli slash finali su POST /api/contacts/ e POST /api/whatsapp/. Implementa retry con backoff in caso di rate limit. Conserva le credenziali lato server e riautenticati prima della scadenza JWT (3600 s).
Sicurezza
Best practice: credenziali solo lato server, TLS obbligatorio, monitoraggio autenticazioni fallite. Separa account staging e produzione. Documenta template e automazioni. Redigi numeri e contenuti nei log condivisi.
Prossimi passi
Esplora contatti e messaggistica: api/contacts api/whatsapp-messaging getting-started/errors