Felhantering

Översikt overview

API-fel i Adobe Experience Platform Edge Network Server API kan ha olika orsaker, interna (Edge Network) eller externa (indata, konfiguration eller uppströms).

Feltyper error-types

Allvarlighetsgrad

Server-API-fel kan också delas upp efter allvarlighetsgrad:

Allvarliga fel fatal-errors

Allvarliga fel stoppar bearbetningen av begäran och orsakar att en svarsstatus som inte är 2xx returneras. Titta i avsnittet feltyper för att se den förväntade statuskoden, som motsvarar varje feltyp.

Felen kommer att åtföljas av ett svarsorgan som innehåller ett felobjekt. I det här fallet innehåller svarstexten en problemdetalj, enligt definition i RFC 7807 Probleminformation för HTTP-API:er.

Den returnerade innehållstypen är medietypen application/problem+json. Det här svaret innehåller maskinläsbar information om felet, om det finns någon. Probleminformationen innehåller en URI-typ.

Alla felobjekt har meddelandeegenskaperna type, status, title, detail och report så att API-klienten kan avgöra vad problemet är.

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

Icke-allvarliga fel non-fatal-errors

Icke-allvarliga fel kan delas upp ytterligare i:

När icke-allvarliga fel påträffas (exklusive varningar) ändrar Server API svarsstatusen till 207 Multi-Status.

Varningar är å andra sidan i huvudsak informativa, eftersom de i allmänhet utgör ett potentiellt övergående tillstånd som inte till fullo påverkade begäran. Ett exempel här är en delvis profilläsning i segmenteringsmotorn. I så fall påverkas noggrannheten i viss utsträckning, men funktionaliteten är fortfarande tillgänglig.

Icke-allvarliga fel representeras i formatet Probleminformation, men bäddas in direkt i Edge gateways standardsvar, som är av typen 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
        }
      }
    }
  ]
}

Hantera 4xx och 5xx svar