Documentazione Adobe Pass Autenticazione Adobe Pass

(Legacy) Recuperare l’elenco delle risorse pre-autorizzate retrieve-list-of-preauthorized-resources

Last update: Mon Jan 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Autenticazione

NOTE

Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente da Adobe. Non è consentito alcun uso non autorizzato.

IMPORTANT

Assicurati di essere sempre informato sugli ultimi annunci di prodotto per l'autenticazione di Adobe Pass e sulle timeline di disattivazione aggregate nella pagina Annunci di prodotto.

NOTE

L'implementazione REST API è limitata dal meccanismo di limitazione

Endpoint REST API clientless-endpoints

<FQDN_REGGIE>:

Produzione - api.auth.adobe.com
Staging - api.auth-staging.adobe.com

<SP_FQDN>:

Produzione - api.auth.adobe.com
Staging - api.auth-staging.adobe.com

Descrizione description

Una richiesta all’autenticazione di Adobe Pass per ottenere l’elenco delle risorse preautorizzate.

Esistono due set di API: un set per Streaming App o Programmer Service e uno per Second Screen Web App. Questa pagina descrive l’API per Streaming App o Programmer Service.

Endpoint

Chiamato
da

Input
Parametri

Metodo HTTP

Risposta

HTTP
Risposta

<SP_FQDN>/api/v1/preauthorize

Servizio programmatore

o

app in streaming

1. richiedente (obbligatorio)
2. deviceId (obbligatorio)
3. resource (obbligatorio)
4. device_info/X-Device-Info (obbligatorio)
5. tipoDispositivo
6. deviceUser (obsoleto)
7. appId (obsoleto)

GET

XML o JSON contenente singole decisioni di pre-autorizzazione o dettagli sull’errore. Vedi gli esempi di seguito.

200 - Operazione completata

400 - Richiesta non valida

401 - Non autorizzato

405 - Metodo non consentito

412 - Precondizione non riuscita

500 - Errore interno del server

Parametro di input

Descrizione

richiedente

ID richiedente del programmatore per il quale è valida questa operazione.

deviceId

Byte ID dispositivo.

resource

Una stringa che contiene un elenco delimitato da virgole di resourceIds che identifica il contenuto che potrebbe essere accessibile a un utente ed è riconosciuto dagli endpoint di autorizzazione di MVPD.

device_info/

X-Device-Info

Informazioni sul dispositivo di streaming.

Nota: questo parametro POTREBBE essere trasmesso come parametro URL_device, ma a causa delle dimensioni potenziali del parametro e delle limitazioni alla lunghezza di un URL di GET, DOVREBBE essere trasmesso come X-Device-Info nell'intestazione http.

Visualizza tutti i dettagli in Trasmissione delle informazioni sul dispositivo e sulla connessione.

tipoDispositivo

Il tipo di dispositivo (ad esempio, Roku, PC).

Se questo parametro è impostato correttamente, ESM offre metriche suddivise per tipo di dispositivo quando si utilizza senza client, in modo che possano essere eseguiti diversi tipi di analisi, ad esempio Roku, AppleTV e Xbox.

Vedi, vantaggi dell'utilizzo del parametro del tipo di dispositivo senza client nelle metriche di passaggio

Nota: device_info sostituirà questo parametro.

utenteDispositivo

L’identificatore utente del dispositivo.

appId

ID/nome dell’applicazione.

Nota: device_info sostituisce questo parametro.

Risposta di esempio sample-response

XML:

HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/xml; charset=utf-8

<resources>
  <resource>
    <id>TestStream1</id>
    <authorized>true</authorized>
  </resource>
  <resource>
    <id>TestStream2</id>
    <authorized>false</authorized>
    <error>
      <status>403</status>
      <code>authorization_denied_by_mvpd</code>
      <message>User not authorized</message>
      <details>Your subscription package does not include the "TestStream3" channel.</details>
      <helpUrl>https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes</helpUrl>
      <trace>0453f8c8-167a-4429-8784-cd32cfeaee58</trace>
      <action>none</action>
    </error>
  </resource>
</resources>

JSON:

HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/json; charset=utf-8

{
   "resources" : [
        {
            "id" : "TestStream1",
            "authorized" : true
        },
        {
            "id" : "TestStream3",
            "authorized" : false,
            "error" : {
               "status" : 403,
               "code" : "authorization_denied_by_mvpd",
               "message" : "User not authorized",
               "details" : "Your subscription package does not include the "TestStream3" channel.",
               "helpUrl" : "https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes",
               "trace" : "0453f8c8-167a-4429-8784-cd32cfeaee58",
               "action" : "none"
            }
        }
    ]
}

recommendation-more-help

3f5e655c-af63-48cc-9769-2b6803cc5f4b