Formato de error JSend
Las llamadas API fallidas devuelven status error, message, code y data en formato JSend. Lea siempre message y code. Causas comunes: acceso API faltante, JWT expirado, números inválidos.
Ejemplo de respuesta de error
Ejemplo de error de validación cuando falta un campo obligatorio.
curl -X POST 'https://app.buzzbip.com/api/contacts/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"firstname": "Jane"}'Lista de comprobación de depuración
Confirma Authorization (Bearer con un espacio). Verifica barras finales. Asegura hasApiAccess activo. Registra status, message y data juntos. Prueba primero GET /api/contacts/.
Registre el cuerpo JSend completo en errores — el mensaje es la pista más rápida.
Notas de integración
Al integrar este endpoint de Buzzbip, use https://app.buzzbip.com como host de producción. Obtenga JWT de POST /api/login_check y envíe Authorization: Bearer en cada solicitud. Confirme que User.hasApiAccess está habilitado en el admin de Buzzbip. Analice respuestas JSend (status, message, data). Para plugins e-commerce, envíe también x-api-key, x-platform-type y x-base-uri. Respete las barras finales en POST /api/contacts/ y POST /api/whatsapp/. Implemente reintentos con backoff ante límites de tasa. Guarde credenciales en el servidor y reautentíquese antes del vencimiento JWT (3600 s).
Seguridad
Buenas prácticas: credenciales solo en servidor, TLS obligatorio, monitorear fallos de autenticación. Separe cuentas staging y producción. Documente plantillas y automatizaciones. Redacte números y contenido en registros compartidos.
¿Qué sigue?
Volver a recursos API: api/contacts getting-started/authentication api/secret-key