Gestiona errores y límites de uso

Distingue cada respuesta

• 401: falta la API key o no es válida.
• 403: la credencial no puede acceder al recurso o la red no está autorizada.
• 404: el agente o la conversación no existen para esa integración.
• 422: el cuerpo, un parámetro o un identificador no es válido.
• 429: se superó el límite de solicitudes.

Los SDK convierten estos estados en errores específicos y conservan el estado y el detalle de la API.

Trata los límites

Cuando recibas 429, consulta Retry-After y espera ese intervalo antes de una nueva petición. Aplica límites también en tu aplicación para evitar picos innecesarios.

Decide cuándo reintentar

Puedes reintentar con espera progresiva una operación idempotente que falle temporalmente. No reintentes automáticamente un stream iniciado ni una creación de respuesta si no puedes determinar si el mensaje ya fue aceptado.

Utiliza Idempotency-Key en las creaciones compatibles cuando necesites proteger una operación frente a repeticiones accidentales.

Registra contexto seguro

Registra el estado HTTP, el código de error y un identificador interno de la operación. Excluye la API key, el contenido sensible y cualquier dato personal que no sea necesario para diagnosticar el fallo.