DocumentazioneAdobe PassAutenticazione Adobe Pass

Ottieni token multimediale breve obtain-short-media-token

Last update: Wed Mar 13 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 di Adobe. Non è consentito alcun uso non autorizzato.
NOTE
L’implementazione REST API è limitata da Meccanismo di limitazione

Endpoint REST API clientless-endpoints

<reggie_fqdn>:

<sp_fqdn>:

Descrizione description

Ottiene un token multimediale breve.

Endpoint
Chiamato
Da
Input
Parametri
HTTP
Metodo
Risposta
HTTP
Risposta
<sp_fqdn>/api/v1/mediatoken

o

<sp_fqdn>/api/v1/tokens/media

Ad esempio:

<sp_fqdn>/api/v1/tokens/media
App di streaming

o

Servizio programmatore
1. richiedente (obbligatorio)
2. deviceId (obbligatorio)
3. resource (obbligatorio)
4. device_info/X-Device-Info (Obbligatorio)
5. deviceType
6. deviceUser (Obsoleto)
7. appId (Obsoleto)
GET
XML o JSON contenente un token multimediale con codifica Base64 o dettagli dell’errore in caso di esito negativo.
200 - Operazione completata
403 - Nessun successo
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 MVPD.
device_info/

X-Device-Info
Informazioni sul dispositivo di streaming.

Nota: questo PUÒ essere trasmesso device_info come parametro URL, ma a causa delle dimensioni potenziali del parametro e delle limitazioni alla lunghezza di un URL GET, DEVE essere trasmesso come X-Device-Info nell’intestazione http.

Vedi tutti i dettagli in Trasmissione delle informazioni sul dispositivo e sulla connessione.
deviceType
Il tipo di dispositivo (ad esempio, Roku, PC).

Se questo parametro è impostato correttamente, ESM offre metriche che sono [suddiviso per tipo di dispositivo]/(help/authentication/entitlement-service-monitoring-overview.md#clientless_device_type) quando si utilizza senza client, in modo da poter eseguire diversi tipi di analisi per. Ad esempio, Roku, AppleTV e Xbox.

Consulta Vantaggi dell'utilizzo del parametro devicetype senza client

Nota: device_info sostituirà questo parametro.
deviceUser
L’identificatore utente del dispositivo.

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

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

Risposta di esempio response

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <play>
        <expires>1348649569000</expires>
        <mvpdId>sampleMvpdId</mvpdId>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <serializedToken>PHNpZ25hdH[...]</serializedToken>
        <userId>sampleScrambledUserId</userId>
    </play>

JSON:

    {
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348649614000",
        "serializedToken": "PHNpZ25hdH[...]",
        "userId": "sampleScrambledUserId",
        "mvpdId": "sampleMvpdId"
    }

Compatibilità con Media Verification Library

Il campo serializedToken dalla chiamata "Ottieni token file multimediale breve" è un token codificato Base64 che può essere verificato in base alla Libreria di verifica degli Adobi Medium.

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b