Errores

Formato de los errores y qué significa cada código.

Todos los errores tienen el mismo formato:

json

{
  "error": {
    "code": "CONTACT_EXISTS",
    "message": "Ya existe un contacto con ese email",
    "details": { "field": "email", "contactId": "8a2e4c61-..." }
  }
}

Estado	Código	Qué pasa
400	BAD_REQUEST	El cuerpo no es JSON o le falta Content-Type: application/json.
401	UNAUTHORIZED	Falta el token o no es válido.
401	TOKEN_REVOKED	El token se ha revocado.
401	TOKEN_EXPIRED	El token ha caducado.
402	NO_CREDITS	No quedan créditos.
402	PAYMENT_REQUIRED	La cuenta tiene un cobro pendiente.
403	PLAN_REQUIRED	La cuenta no tiene el plan Agentes ilimitados.
403	FORBIDDEN_SCOPE	El token no tiene permiso para esa operación.
404	NOT_FOUND	El recurso no existe o no es tuyo.
409	CONTACT_EXISTS	Ya hay un contacto con ese email o teléfono.
413	PAYLOAD_TOO_LARGE	El cuerpo pasa de 64 KB.
422	VALIDATION_ERROR	Algún dato no es válido (details indica cuál).
429	RATE_LIMITED	Demasiadas llamadas por minuto.
500	INTERNAL	Error inesperado. Vuelve a intentarlo en unos minutos.

URL base: https://agentclic.com/api/public/pro/v1