DocumentazioneAdobe PassAutenticazione Adobe Pass

(Legacy) Recupera token di autorizzazione retrieve-authorization-token

Last update: Sat Dec 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
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>:

<SP_FQDN>:

Descrizione description

Recupera il token di autorizzazione (AuthZ).

Endpoint
Chiamato
da
Input
Parametri
Metodo HTTP
Risposta
HTTP
Risposta
<SP_FQDN>/api/v1/tokens/authz

Esempio:

<SP_FQDN>/api/v1/tokens/authz
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
1. Operazione completata
2. Token di autenticazione
non trovato o scaduto:
XML che spiega il motivo
token di autenticazione non trovato
3. Token di autorizzazione
non trovato:
spiegazione XML
4. Token di autorizzazione
scaduto:
Spiegazione XML
200 - Operazione completata
412 - Nessuna AuthN

404 - Nessuna AuthZ

410 - AuthZ scaduta
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 resourceId (o frammento MRSS), identifica il contenuto richiesto da un utente ed è riconosciuta 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.

Consulta, Vantaggi dell'utilizzo del parametro del tipo di dispositivo senza client nelle metriche di passaggio

Nota: il parametro device_info verrà sostituito.
utenteDispositivo
L’identificatore utente del dispositivo.
appId
ID/nome dell’applicazione.

Nota: device_info sostituisce questo parametro.

Risposta di esempio response

Completato

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authorization>
        <expires>1348148289000</expires>
        <mvpd>sampleMvpdId</mvpd>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <proxyMvpd>sampleProxyMvpdId</proxyMvpd>
    </authorization>

JSON:

    {
        "mvpd": "sampleMvpdId",
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348148289000",
        "proxyMvpd": "sampleProxyMvpdId"
    }

Token di autenticazione non trovato o scaduto:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>412</status>
        <message>User not authenticated</message>
    </error>

JSON:

    {
        "status": 412,
        "message": "User not authenticated",
        "details": null
    }

Token di autorizzazione non trovato:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>404</status>
        <message>Not found</message>
    </error>

JSON:

    {
        "status": 404,
        "message": "Not Found",
        "details": null
    }

Token di autorizzazione scaduto:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>410</status>
        <message>Gone</message>
    </error>

JSON:

    {
        "status": 410,
        "message": "Gone",
        "details": null
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b