Códigos de error mejorados enhanced-error-codes

Los códigos de error mejorados representan una función de autenticación de Adobe Pass que proporciona información de error adicional a las aplicaciones cliente integradas con:

Representación enhanced-error-codes-representation

Los códigos de error mejorados se pueden representar en formato JSON o XML según la API de autenticación de Adobe Pass integrada y el valor de encabezado "Accept" utilizado (es decir, application/json o application/xml):

Consulte las siguientes respuestas HTTP que contienen ejemplos de códigos de error mejorados representados como 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=es",
  "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=es</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=es",
        "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=es",
  "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=es",
        "trace": "12f6fef9-d2e0-422b-a9d7-60d799abe353"
      }
    }
  ]
}

Los códigos de error mejorados incluyen los siguientes JSON campos o atributos XML:

Acción enhanced-error-codes-representation-action

Los códigos de error mejorados incluyen un campo "acción" que proporciona una acción recomendada que podría remediar la situación.

Los valores posibles del campo "acción" incluyen:

(*) Para algunos errores, varias acciones podrían ser posibles soluciones, pero el campo "acción" indica la que tiene la mayor probabilidad de corregir el error.

Estado enhanced-error-codes-representation-status

Los códigos de error mejorados incluyen un campo "estado" que indica el código de estado HTTP asociado al error.

Los valores posibles del campo "estado" incluyen:

Los códigos de error mejorados con un "estado" 4xx generalmente aparecen cuando el cliente genera el error y la mayoría de las veces implica que el cliente requiere trabajo adicional para corregirlo.

Los códigos de error mejorados con un "estado" 5xx generalmente aparecen cuando el servidor genera el error y la mayoría de las veces implica que el servidor requiere trabajo adicional para corregirlo.

Código enhanced-error-codes-representation-code

Los códigos de error mejorados incluyen un campo "código" que proporciona un identificador único de autenticación de Adobe Pass asociado con el error.

Los valores posibles para el campo "código" se agregan debajo de en dos listas basadas en la API de autenticación de Adobe Pass integrada.

Listas enhanced-error-codes-lists

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

En la tabla siguiente se enumeran los posibles códigos de error mejorados que una aplicación cliente podría encontrar al integrarse con la API de REST de autenticación de Adobe Pass v1.

API de preautorización de SDK enhanced-error-codes-lists-sdks-preauthorize-api

Consulte la sección anterior para ver los posibles códigos de error mejorados que podría encontrar una aplicación cliente al integrarse con la API de autorización previa del SDK de autenticación de Adobe Pass.

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

En la tabla siguiente se enumeran los posibles códigos de error mejorados que una aplicación cliente podría encontrar al integrarse con la API de REST de autenticación de Adobe Pass v2.

Gestión de respuestas enhanced-error-codes-response-handling

En resumen, al administrar respuestas que contengan códigos de error mejorados, debe tener en cuenta lo siguiente: