Recupera token di autenticazione retrieve-authentication-token

NOTE
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente di Adobe. Non è consentito alcun uso non autorizzato.
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 autenticazione (AuthN).

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

Esempio:

<SP_FQDN>/api/v1/tokens/authn
Servizio programmatore

o

app in streaming
1. richiedente (obbligatorio)
2. deviceId (obbligatorio)
3. device_info/X-Device-Info (obbligatorio)
4. deviceType (obsoleto)
5. deviceUser (obsoleto)
6. appId (obsoleto)
GET
XML o JSON contenente informazioni di autenticazione o dettagli sull’errore in caso di esito negativo.
200 - Operazione completata.
404 - Token non trovato
410 - Token scaduto
Parametro di input
Descrizione
richiedente
ID richiedente del programmatore per il quale è valida questa operazione.
deviceId
Byte ID dispositivo.
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).

Nota: device_info sostituisce questo parametro.
utenteDispositivo
L’identificatore utente del dispositivo.

Nota: se utilizzato, deviceUser deve avere gli stessi valori della richiesta Crea codice di registrazione.
appId
ID/nome dell’applicazione.

Nota: device_info sostituisce questo parametro. Se utilizzato, appId deve avere gli stessi valori della richiesta Crea codice di registrazione.

Risposta di esempio response

Completato

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authentication>
         <expires>1601114932000</expires>
         <userId>sampleUserId</userId>
         <mvpd>sampleMvpdId</mvpd>
         <requestor>sampleRequestor</requestor>
    </authentication>

JSON:

    {
         "requestor": "sampleRequestor",
         "mvpd": "sampleMvpdId",
         "userId": "sampleUserId",
         "expires": "1601114932000"
    }

Token di autenticazione 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"
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b