Foutafhandeling

Overzicht overview

API-fouten in de Adobe Experience Platform Edge Network Server-API kunnen verschillende oorzaken hebben: intern (Edge Network zelf) of extern (invoer, configuratie of upstream gerelateerd).

Fouttypen error-types

Ernst

Server-API-fouten kunnen ook worden gesplitst op ernst:

Fatale fouten fatal-errors

Fatale fouten stoppen de verzoekverwerking en veroorzaken dat een non-2xx reactiestatus wordt teruggekeerd. Controle uit de foutentypessectie om de verwachte statuscode te zien, die aan elk foutentype beantwoordt.

Fouten gaan vergezeld van een antwoordinstantie die een foutobject bevat. In dit geval, bevat het reactielichaam een probleemdetail, zoals bepaald door RFC 7807 Details van het Probleem voor HTTP APIs.

Het geretourneerde inhoudstype is het mediatype application/problem+json . Indien aanwezig bevat dit antwoord machineleesbare details met betrekking tot de fout. De details van het probleem omvatten een type van URI.

Alle foutobjecten hebben een berichteigenschap type , status , title , detail en report , zodat de API-client kan zien wat het probleem is.

{
   "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"
   }
}

Niet-fatale fouten non-fatal-errors

Niet-fatale fouten kunnen verder worden onderverdeeld in:

Bij niet-fatale fouten (behalve waarschuwingen) wijzigt Server API de status van de reactie in 207 Multi-Status .

Waarschuwingen daarentegen zijn meestal informatief, aangezien ze over het algemeen een potentieel voorbijgaande voorwaarde vormen, die het verzoek niet volledig heeft beïnvloed. Een voorbeeld hiervan is een gedeeltelijk profiel dat in de segmenteringsengine wordt gelezen. In dat geval wordt de nauwkeurigheid enigszins beïnvloed, maar de functionaliteit wordt nog steeds geleverd.

De niet fatale fouten worden vertegenwoordigd in het formaat van de Details van het Probleem, maar zijn direct ingebed in de standaardreactie van de gateway van Edge, die van type application/json is.

{
  "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
        }
      }
    }
  ]
}

4xx - en 5xx reacties verwerken