Codici di errore migliorati enhanced-error-codes

I codici di errore avanzati rappresentano una funzione di autenticazione di Adobe Pass che fornisce informazioni aggiuntive sugli errori alle applicazioni client integrate con:

Rappresentazione enhanced-error-codes-representation

I codici di errore avanzati possono essere rappresentati nel formato JSON o XML a seconda dell'API di autenticazione Adobe Pass integrata e del valore di intestazione "Accept" utilizzato (ad esempio application/json o application/xml):

Fare riferimento alle seguenti risposte HTTP contenenti esempi di codici di errore avanzati rappresentati come JSON o 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=it",
  "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=it</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=it",
        "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=it",
  "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=it",
        "trace": "12f6fef9-d2e0-422b-a9d7-60d799abe353"
      }
    }
  ]
}

I codici di errore avanzati includono i seguenti campi JSON o attributi XML:

Azione enhanced-error-codes-representation-action

I codici di errore avanzati includono un campo "action" che fornisce un’azione consigliata che potrebbe risolvere la situazione.

I valori possibili per il campo "azione" includono:

(*) Per alcuni errori, potrebbero essere possibili più azioni, ma il campo "action" indica quella con la maggiore probabilità di correggere l'errore.

Stato enhanced-error-codes-representation-status

I codici di errore avanzati includono un campo "status" che indica il codice di stato HTTP associato all’errore.

I valori possibili per il campo "status" includono:

Codici di errore migliorati con uno "stato" 4xx vengono in genere visualizzati quando l’errore viene generato dal client e la maggior parte delle volte implica che il client richiede un lavoro aggiuntivo per correggerlo.

Codici di errore migliorati con uno "stato" 5xx vengono in genere visualizzati quando l’errore viene generato dal server e la maggior parte delle volte implica che il server richiede un lavoro aggiuntivo per correggerlo.

Codice enhanced-error-codes-representation-code

I codici di errore avanzati includono un campo "code" che fornisce un identificatore univoco di autenticazione Adobe Pass associato all’errore.

I valori possibili per il campo "code" sono aggregati di seguito in due elenchi basati sull'API di autenticazione Adobe Pass integrata.

Elenchi enhanced-error-codes-lists

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

La tabella seguente elenca i possibili codici di errore avanzati che un’applicazione client potrebbe incontrare quando integrata con l’API REST di autenticazione di Adobe Pass v1.

API di pre-autorizzazione SDK enhanced-error-codes-lists-sdks-preauthorize-api

Consulta la sezione precedente per informazioni sui possibili codici di errore avanzati che un'applicazione client potrebbe incontrare quando integrata con l'API di preautorizzazione degli SDK di autenticazione di Adobe Pass.

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

La tabella seguente elenca i possibili codici di errore avanzati che un’applicazione client potrebbe incontrare quando integrata con l’API REST di autenticazione di Adobe Pass v2.

Gestione della risposta enhanced-error-codes-response-handling

In sintesi, quando gestisci le risposte contenenti codici di errore avanzati, prendi in considerazione quanto segue: