Verbeterde foutcodes enhanced-error-codes

Enhanced Error Codes vertegenwoordigen een Adobe Pass-verificatiefunctie die aanvullende foutinformatie biedt voor clienttoepassingen die zijn geïntegreerd met:

Vertegenwoordiging enhanced-error-codes-representation

Enhanced Error Codes kunnen worden weergegeven in de JSON - of XML -indeling, afhankelijk van de geïntegreerde Adobe Pass Authentication API en de gebruikte headerwaarde Accept (d.w.z. application/json of application/xml):

Raadpleeg de volgende HTTP-reacties met voorbeelden van uitgebreide foutcodes die worden weergegeven als JSON of XML .

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "action": "none",
  "status": 400,
  "code": "invalid_requestor",
  "message": "The requestor parameter is missing or invalid.",
  "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=nl-NL",
  "trace": "8bcb17f9-b172-47d2-86d9-3eb146eba85e"
}

HTTP/1.1 400 Bad Request
Content-Type: application/xml

<error>
  <action>none</action>
  <status>400</status>
  <code>invalid_requestor</code>
  <message>The requestor parameter is missing or invalid.</message>
  <helpUrl>https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=nl-NL</helpUrl>
  <trace>8bcb17f9-b172-47d2-86d9-3eb146eba85e</trace>
</error>

HTTP/1.1 200 OK
Content-Type: application/json

{
  "resources": [
    {
      "id": "TestStream1",
      "authorized": true
    },
    {
      "id": "TestStream2",
      "authorized": false,
      "error": {
        "action": "retry",
        "status": 403,
        "code": "network_connection_failure",
        "message": "Unable to contact your TV provider services",
        "details": "Your subscription package does not include the \"Live\" channel",
        "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=nl-NL",
        "trace": "12f6fef9-d2e0-422b-a9d7-60d799abe353"
      }
    }
  ]
}

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "action": "none",
  "status": 400,
  "code": "invalid_parameter_service_provider",
  "message": "The service provider parameter value is missing or invalid.",
  "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=nl-NL",
  "trace": "12f6fef9-d2e0-422b-a9d7-60d799abe353"
}

HTTP/1.1 200 OK
Content-Type: application/json

{
  "decisions": [
    {
      "resource": "REF30",
      "serviceProvider": "REF30",
      "mvpd": "Cablevision",
      "source": "mvpd",
      "authorized": true,
      "token": {
        "issuedAt": 1697094207324,
        "notBefore": 1697094207324,
        "notAfter": 1697094802367,
        "serializedToken": "PHNpZ25hdHVyZUluZm8..."
      }
    },
    {
      "resource": "REF40",
      "serviceProvider": "REF40",
      "mvpd": "Cablevision",
      "source": "mvpd",
      "authorized": false,
      "error" : {
        "action": "retry",
        "status": 403,
        "code": "network_connection_failure",
        "message": "Unable to contact your TV provider services",
        "details": "Your subscription package does not include the \"Live\" channel",
        "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=nl-NL",
        "trace": "12f6fef9-d2e0-422b-a9d7-60d799abe353"
      }
    }
  ]
}

Uitgebreide foutcodes bevatten de volgende JSON velden of XML kenmerken:

Handeling enhanced-error-codes-representation-action

De uitgebreide foutcodes bevatten een veld "Handeling" met een aanbevolen handeling die de situatie zou kunnen verhelpen.

De mogelijke waarden voor het veld "Handeling" zijn:

(*) Voor sommige fouten, zouden de veelvoudige acties mogelijke oplossingen kunnen zijn, maar het gebied van de "actie"wijst met de hoogste waarschijnlijkheid aan om de fout te bevestigen.

Status enhanced-error-codes-representation-status

Uitgebreide foutcodes bevatten een veld "status" dat de HTTP-statuscode aangeeft die aan de fout is gekoppeld.

De mogelijke waarden voor het veld status zijn:

Verbeterde foutcodes met een 4xx-"status" worden meestal weergegeven wanneer de fout door de client wordt gegenereerd en meestal impliceert dit dat de client extra werk nodig heeft om de fout te verhelpen.

Uitgebreide foutcodes met een "status" van 5 xx worden meestal weergegeven wanneer de fout door de server wordt gegenereerd en het grootste deel van de tijd dat dit impliceert dat de server extra werk nodig heeft om de fout te verhelpen.

Code enhanced-error-codes-representation-code

Uitgebreide foutcodes bevatten een veld "code" met een unieke id voor Adobe Pass-verificatie die aan de fout is gekoppeld.

De mogelijke waarden voor het "code"gebied worden samengevoegd hieronderin twee lijsten die op de geïntegreerde Authentificatie API van Adobe Pass worden gebaseerd.

Lijsten enhanced-error-codes-lists

REST API v1 enhanced-error-codes-lists-rest-api-v1

In de onderstaande tabel worden mogelijke Enhanced Error Codes weergegeven die een clienttoepassing kan tegenkomen bij integratie met Adobe Pass Authentication REST API v1.

API voor voorafgaande autorisatie van SDK's enhanced-error-codes-lists-sdks-preauthorize-api

Verwijs naar de vorige sectievoor mogelijke Verbeterde Codes van de Fout een cliënttoepassing zou kunnen ontmoeten wanneer geïntegreerd met de Authentificatie SDKs van Adobe Pass preauthorize API.

REST API v2 enhanced-error-codes-lists-rest-api-v2

In de onderstaande tabel worden mogelijke Enhanced Error Codes weergegeven die een clienttoepassing kan tegenkomen bij integratie met Adobe Pass Authentication REST API v2.

Reactieafhandeling enhanced-error-codes-response-handling

Samenvattend, wanneer het behandelen van reacties die de Geavanceerde Codes van de Fout bevatten, zou u het volgende moeten overwegen: