Errores comunes

429 Too Many Requests: El límite es de no más de 500 solicitudes cada 5 segundos. El contador se restablece cada 5 segundos, después de lo cual puedes enviar nuevas solicitudes.

401 Unauthorized: No se proporcionó una clave API o la clave es incorrecta.

500 Internal Server Error: Error interno del servidor.

403 Forbidden: Las solicitudes a rutas no permitidas para el uso con una clave API tipo sidecar pueden generar este error.

TOO_MANY_ENTITIES: Las siguientes rutas tienen un límite en la cantidad de entidades que se pueden procesar a la vez — no más de 100 elementos por solicitud:

  • POST /contacts
  • POST /users
  • POST /deals
  • PATCH /contacts/bulk_delete
  • PATCH /deals/bulk_delete

Formato de error

Cuando se produce un error, se devuelve un código de estado 4XX. El cuerpo de la respuesta estará vacío o contendrá un objeto JSON con el siguiente formato:

{
error: 'ERROR CODE',
description: 'CHANNEL_BLOCKED', // descripción breve del error en inglés
[data]: {} // objeto opcional con información adicional, destinado al análisis por parte de desarrolladores para identificar la causa.
}