Control de errores

Información general

Los errores de API en la API de Adobe Experience Platform Edge Network Server pueden tener una variedad de causas, internas (la propia red perimetral) o externas (relacionadas con la entrada, la configuración o el flujo ascendente).

Tipos de error

Gravedad

Los errores de API de servidor también se pueden dividir por gravedad:

• Errores fatales detendrá la canalización de envío.
• Errores no mortales podría indicar un procesamiento parcial, mientras que se permite que continúe el procesamiento de la solicitud.
  • Cuando está presente, el código de estado general de la solicitud se cambia a 207 Multi-Status.

Errores fatales

Los errores fatales detienen el procesamiento de la solicitud y provocan que se devuelva un estado de respuesta que no sea de 2xx. Consulte la tipos de error para ver el código de estado esperado, correspondiente a cada tipo de error.

Los errores irán acompañados de un cuerpo de respuesta que contenga un objeto de error. En este caso, el cuerpo de la respuesta contiene un detalle del problema, tal como se define en RFC 7807 Detalles del problema para las API HTTP.

El tipo de contenido devuelto es el application/problem+json tipo de medio. Cuando está presente, esta respuesta contiene detalles legibles por el equipo que pertenecen al error. Los detalles del problema incluyen un tipo de URI.

Todos los objetos de error tienen un valor type, status, title, detail y report para que el cliente de API pueda saber cuál es el problema.

{
   "type":"https://ns.adobe.com/aep/errors/EXEG-0104-422",
   "status":422,
   "title":"Unprocessable entity",
   "detail":"Invalid request (report attached). Please check your input and try again.",
   "report":{
      "errors":[
         "Allowed Adobe version is 1.0 for standard 'Adobe' at index 0",
         "Allowed IAB version is 2.0 for standard 'IAB TCF' at index 1",
         "IAB consent string value must not be empty for standard 'IAB TCF' at index 1"
      ],
      "requestId":"0f8821e5-ed1a-4301-b445-5f336fb50ee8",
      "orgId":"53A16ACB5CC1D3760A495C99@AdobeOrg"
   }
}

Errores no mortales

Los errores no mortales pueden desglosarse en:

• Errores: Problemas que se produjeron durante el procesamiento de la solicitud, pero que no hicieron que se rechazara toda la solicitud (p. ej. un error ascendente no crítico).
• Advertencias: Mensajes de los servicios de subida que podrían indicar que se ha producido un procesamiento parcial de la solicitud.

Cuando se encuentran errores no mortales (excluidas las advertencias), la variable Server API cambiará el estado de la respuesta a 207 Multi-Status.

Las advertencias, por otra parte, son en su mayoría informativas, ya que generalmente representan una condición potencialmente transitoria, que no afectó a la solicitud en su totalidad. Un ejemplo a continuación es una lectura parcial del perfil en el motor de segmentación, en cuyo caso la precisión se ve afectada hasta cierto punto, pero la funcionalidad sigue estando disponible.

Los errores no mortales se representan en la variable Detalles del problema , pero están incrustados directamente en la respuesta estándar de Edge gateway, que es del tipo application/json.

{
  "requestId": "72eaa048-207e-4dde-bf16-0cb2b21336d5",
  "handle": [
  ],
  "errors": [
    {
      "type": "https://ns.adobe.com/aep/errors/EXEG-0201-503",
      "status": 503,
      "title": "The 'com.adobe.experience.platform.ode' service is temporarily unable to serve this request. Please try again later."
    }
  ],
  "warnings": [
    {
      "type": "https://ns.adobe.com/aep/errors/EXEG-0204-200",
      "status": 200,
      "title": "A warning occurred while calling the 'com.adobe.audiencemanager' service for this request.",
      "report": {
        "cause": {
          "message": "Cannot read related customer for device id: ...",
          "code": 202
        }
      }
    }
  ]
}

Gestión 4xx y 5xx Respuestas

Recursos de Business.Adobe.com