Tratamento de erros

Visão geral

Os erros de API na API do Servidor de Rede de Borda do Adobe Experience Platform podem ter várias causas, internas (própria Rede de Borda) ou externas (entrada, configuração ou relacionadas a upstream).

Tipos de erro

Gravidade

Os erros da API do servidor também podem ser divididos por gravidade:

• Erros fatais interromperá o pipeline de despacho.
• Erros não fatais O pode sinalizar um processamento parcial, permitindo que o processamento da solicitação continue.
  • Quando presente, o código de status geral da solicitação será alterado para 207 Multi-Status.

Erros fatais

Erros fatais interrompem o processamento da solicitação e fazem com que um status de resposta não 2xx seja retornado. Confira o tipos de erro para ver o código de status esperado, correspondente a cada tipo de erro.

Os erros serão acompanhados por um corpo de resposta contendo um objeto de erro. Nesse caso, o corpo da resposta contém um detalhe do problema, conforme definido por Detalhes do problema RFC 7807 para APIs HTTP.

O tipo de conteúdo retornado é a variável application/problem+json tipo de mídia. Quando presente, essa resposta contém detalhes legíveis por máquina relacionados ao erro. Os detalhes do problema incluem um tipo de URI.

Todos os objetos de erro têm uma type, status, title, detail e report propriedades da mensagem para que o cliente da API possa saber qual é o 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"
   }
}

Erros não fatais

Os erros não fatais podem ser divididos em:

• Erros: Problemas que ocorreram ao processar a solicitação, mas não fizeram com que toda a solicitação fosse rejeitada (por exemplo, uma falha não crítica de upstream).
• Avisos: Mensagens de serviços upstream que poderiam sinalizar que ocorreu um processamento parcial da solicitação.

Ao encontrar erros não fatais (excluindo avisos), a variável Server API alterará o status da resposta para 207 Multi-Status.

Os avisos, por outro lado, são na sua maioria informativos, uma vez que geralmente representam uma condição potencialmente transitória, que não afetou totalmente a solicitação. Um exemplo aqui é um perfil parcial lido no mecanismo de segmentação, nesse caso a precisão é afetada até certo ponto, mas a funcionalidade ainda é oferecida.

Erros não fatais são representados na variável Detalhes do problema , mas são incorporados diretamente na resposta padrão do gateway do Edge, que é do 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
        }
      }
    }
  ]
}

Manuseio 4xx e 5xx Respostas

Recursos do Business.Adobe.com