Errores y respuestas de la API

Este artículo de referencia cubre los distintos errores y respuestas del servidor que pueden surgir al utilizar la API de Braze y cómo solucionarlos.

Respuestas del servidor

Si nuestros servidores han aceptado tu carga útil POST, los mensajes correctos recibirán la siguiente respuesta:

1
2
3
{
  "message" : "success"
}

Ten en cuenta que el éxito solo significa que la carga útil de la API RESTful se formó correctamente y se transmitió a nuestros servicios de notificación push, correo electrónico u otros servicios de mensajería. Esto no significa que los mensajes se hayan entregado realmente, ya que hay factores adicionales que podrían impedir la entrega del mensaje (por ejemplo, un dispositivo podría estar desconectado, el token de notificaciones push podría ser rechazado por los servidores de Apple o podrías haber proporcionado un ID de usuario desconocido).

Para puntos de conexión como /users/identify, que no envían mensajes, un mensaje de éxito solo significa que Braze ha recibido la solicitud para su procesamiento. Si no hay ninguna coincidencia para el alias después del procesamiento, la solicitud se detiene.

Si tu mensaje se envía correctamente pero contiene errores no fatales, recibirás la siguiente respuesta:

1
2
3
{
  "message" : "success", "errors" : [<minor error message>]
}

En caso de éxito, los mensajes que no se hayan visto afectados por un error en la matriz errors se seguirán entregando. Si tu mensaje contiene un error fatal, recibirás la siguiente respuesta:

1
2
3
{
  "message" : <fatal error message>, "errors" : [<minor error message>]
}

Respuestas para los ID de envío rastreados

Los análisis están siempre disponibles para las campañas. Además, los análisis están disponibles para una instancia de envío de campaña específica cuando la campaña se envía como difusión. Cuando el seguimiento está disponible para una instancia de envío de campaña específica, recibes la siguiente respuesta:

1
2
3
{
  "message": "success", "send_id" : "example_send_id"
}

El identificador de envío proporcionado puede utilizarse como parámetro para que el punto de conexión /send/data_series recupere análisis específicos del envío.

Errores

El elemento de código de estado de una respuesta del servidor es un número de 3 dígitos en el que el primer dígito del código define la clase de respuesta.

• La clase 2XX de código de estado (no fatal) indica que tu solicitud ha sido recibida, comprendida y aceptada correctamente.
• La clase 4XX de código de estado (fatal) indica un error del cliente. Consulta la tabla de errores fatales para obtener una lista completa de los códigos de error 4XX y sus descripciones.
• La clase 5XX de código de estado (fatal) indica un error del servidor. Hay varias causas posibles, por ejemplo, el servidor al que intentas acceder no puede ejecutar la solicitud, el servidor está en mantenimiento por lo que no puede ejecutar la solicitud, o el servidor está experimentando altos niveles de tráfico. Cuando esto ocurra, te recomendamos que reintentes tu solicitud con retirada exponencial. En caso de incidente o interrupción, Braze no puede reproducir ninguna llamada a la API REST que haya fallado durante la ventana del incidente. Debes volver a intentar cualquier llamada que haya fallado durante la ventana del incidente.
  • Un error 502 es un fallo que se produce antes de llegar al servidor de destino.
  • Un error 503 significa que la solicitud llegó al servidor de destino, pero no podemos completarla porque no hay suficiente capacidad, hay un problema de red o algo similar.
  • Un error 504 indica que un servidor no ha recibido una respuesta de otro servidor ascendente.

Errores fatales

Si tu solicitud encuentra un error fatal, se devolverán los siguientes códigos de estado y mensajes de error asociados.