DocumentazioneAdobe PassAutenticazione Adobe Pass

Ottieni token multimediale breve obtain-short-media-token

Last update: Sat Jul 20 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 dal meccanismo di limitazione

Endpoint REST API clientless-endpoints

<FQDN_REGGIE>:

<SP_FQDN>:

Descrizione description

Ottiene un token multimediale breve.

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

o

<SP_FQDN>/api/v1/tokens/media

Esempio:

<SP_FQDN>/api/v1/tokens/media
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 un token multimediale con codifica Base64 o dettagli dell’errore in caso di esito negativo.
200 - Operazione riuscita
403 - Nessuna operazione riuscita
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 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]/(help/authentication/entitlement-service-monitoring-overview.md#clientless_device_type) quando si utilizza senza client, in modo che possano essere eseguiti diversi tipi di analisi per. Ad esempio, Roku, AppleTV e Xbox.

Consulta Vantaggi dell'utilizzo del parametro clientless devicetype

Nota: device_info sostituirà 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

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 della chiamata "Ottieni token file multimediali brevi" è un token codificato Base64 che può essere verificato in base alla libreria di verifica Adobe Medium.

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