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 aceptaron la payload de tu POST, recibirá un mensaje exitoso con la siguiente respuesta:

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

Ten en cuenta que el éxito solo significa que la payload de la API RESTful se formó correctamente y se pasó a nuestra notificación push, correo electrónico u otros servicios de mensajería. Esto no significa que los mensajes hayan sido realmente entregados, ya que otros factores podrían impedir la entrega del mensaje (por ejemplo, un dispositivo podría estar fuera de línea, el token push podría ser rechazado por los servidores de Apple, puede que hayas proporcionado un ID de usuario desconocido).

Si tu mensaje tiene éxito, 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 enviando. Si tu mensaje tiene 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, recibirá 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 final /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 de código de estado 2XX (no fatal) indica que su solicitud ha sido recibida, comprendida y aceptada correctamente.
• La clase de código de estado 4XX (fatal) indica un error del cliente. Consulte la tabla de errores fatales para obtener una lista completa de los códigos de error 4XX y sus descripciones.
• La clase de código de estado 5XX (fatal) indica un error del servidor. Hay varias causas posibles, por ejemplo, el servidor al que intenta 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, le recomendamos que reintente su petición con un backoff 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. Deberá reintentar las llamadas que hayan fallado durante la ventana de incidencias.
  • Un error 502 es un fallo antes de llegar al servidor de destino.
  • Un error 503 significa que la solicitud ha llegado al servidor de destino, pero no podemos completarla porque no hay capacidad suficiente, o hay un problema de red, o algo similar.
  • Un error 504 indica que un servidor no ha recibido una respuesta de otro servidor anterior.

Errores fatales

Los siguientes códigos de estado y mensajes de error asociados serán devueltos si su solicitud encuentra un error fatal.