Qué es
YCloud utiliza códigos de estado HTTP y un cuerpo de error estructurado para que tu aplicación pueda decidir si corregir, rechazar o reintentar una solicitud.Respuesta
Una solicitud fallida devuelve un objetoerror.
Campos de error
Códigos de error
Usaerror.code para distinguir fallos que comparten un estado HTTP. Este catálogo enumera los códigos de error de la API de YCloud; un endpoint puede documentar errores adicionales.
Para consultar las cuotas de cuenta y remitente, consulta Límites de velocidad.
Los errores de Meta también pueden aparecer en
error.whatsappApiError después de que una solicitud llega a
WhatsApp. Conserva esos detalles junto con el código de error de YCloud.
Cómo gestionar la respuesta
Correlación de solicitudes
Registra el endpoint, el método HTTP, el estado de la respuesta, elrequestId de YCloud y tu propio
ID de correlación. Elimina las claves de API y los datos personales. Esto te proporciona suficiente
evidencia para investigar un fallo sin exponer secretos.
Reintentar de forma segura
Reintenta las solicitudes de solo lectura cuando el fallo sea temporal. Ten precaución con los envíos de mensajes y otras operaciones de creación. UnPOST repetido puede crear un segundo recurso o enviar un mensaje duplicado.
Cuando el esquema de la solicitud lo admita, establece externalId con un valor único de tu sistema. Guarda el ID de respuesta de YCloud tras una solicitud correcta.
Lista de comprobación de implementación
- Analiza los errores por
code, no haciendo coincidir el texto demessage. - Configura tiempos de espera en cada solicitud saliente.
- Reintenta únicamente los fallos temporales.
- Añade retroceso exponencial, variación aleatoria y un número máximo de intentos.
- Evita efectos duplicados de
POSTcon tu propio identificador estable cuando la solicitud lo admita.

