Vue d'ensemble
Après avoir obtenu un JWT, vérifiez la connectivité avec une requête GET authentifiée simple. La liste des contacts est un bon test : elle valide le token et retourne un petit JSON. Utilisez https://app.buzzbip.com et le slash final sur certains POST.
Exemple de requête
Listez la première page de contacts avec la pagination par défaut.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'Interpréter la réponse
Une réponse JSend réussie a status success, un message lisible et un champ data. Les erreurs utilisent status error avec message, code et data. Vérifiez toujours le corps JSON, pas seulement le code HTTP.
Journalisez les corps JSend complets pendant les tests d'intégration.
Notes d'intégration
Lors de l'intégration de ce endpoint Buzzbip, utilisez https://app.buzzbip.com comme hôte de production. Obtenez un JWT via POST /api/login_check et envoyez Authorization: Bearer sur chaque requête. Vérifiez que User.hasApiAccess est activé dans l'admin Buzzbip. Analysez les réponses JSend (status, message, data). Pour les plugins e-commerce, envoyez aussi x-api-key, x-platform-type et x-base-uri. Respectez les slashs finaux sur POST /api/contacts/ et POST /api/whatsapp/. Implémentez des nouvelles tentatives avec backoff en cas de limite de débit. Stockez les identifiants côté serveur et réauthentifiez-vous avant l'expiration du JWT (3600 s).
Sécurité
Bonnes pratiques : credentials uniquement côté serveur, TLS obligatoire, surveillance des échecs d'authentification. Séparez comptes staging et production. Documentez modèles et automatisations déclenchés. Masquez numéros et contenus dans les journaux partagés.
Et ensuite ?
Explorez contacts et messagerie : api/contacts api/whatsapp-messaging getting-started/errors