Saltar al contenido principal

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 objeto error.

Campos de error

Códigos de error

Usa error.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, el requestId 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. Un POST 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.
Si tienes un gestor de cuentas, ponte en contacto con él. De lo contrario, envía un ticket a través de YCloud Ticket Service. Incluye el requestId, el endpoint, el estado HTTP y la hora del fallo. Elimina las claves de API y los datos personales antes de compartir estos detalles.

Lista de comprobación de implementación

  • Analiza los errores por code, no haciendo coincidir el texto de message.
  • 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 POST con tu propio identificador estable cuando la solicitud lo admita.