DokumentationAdobe PassAdobe Pass-autentisering

Hämta kort medietoken obtain-short-media-token

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
Innehållet på den här sidan tillhandahålls endast i informationssyfte. Användning av denna API kräver en aktuell licens från Adobe. Ingen obehörig användning är tillåten.
NOTE
REST API-implementeringen begränsas av Begränsningsmekanismen

REST API-slutpunkter clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

Beskrivning description

Hämtar kort medietoken.

Slutpunkt
Anropat
av
Indata
Parametrar
HTTP
Metod
Svar
HTTP
Response
<SP_FQDN>/api/v1/mediatoken

eller

<SP_FQDN>/api/v1/tokens/media

Till exempel:

<SP_FQDN>/api/v1/tokens/media
Direktuppspelande app

eller

Programmeringtjänst
1. beställare (obligatoriskt)
2. deviceId (obligatoriskt)
3. resurs (obligatoriskt)
4. device_info/X-Device-Info (obligatoriskt)
5. deviceType
6. deviceUser (utgått)
7. appId (inaktuellt)
GET
XML eller JSON som innehåller en Base64-kodad medietoken eller felinformation om felet misslyckas.
200 - lyckades
403 - misslyckades
Indataparameter
Beskrivning
begärande
Programmerarens requestId som den här åtgärden är giltig för.
deviceId
Byte för enhets-ID.
resurs
En sträng som innehåller ett resourceId (eller MRSS-fragment), identifierar innehållet som begärts av en användare och känns igen av MVPD-auktoriseringsslutpunkter.
device_info/

X-Device-Info
Information om direktuppspelningsenhet.

Obs!: Detta kan skickas som device_info som URL-parameter, men på grund av parameterns potentiella storlek och begränsningar i längden på en GET-URL, bör det skickas som X-Device-Info i http-huvudet.

Mer information finns i Skicka information om enheter och anslutningar.
deviceType
Enhetstypen (till exempel Roku, PC).

Om den här parametern är korrekt har ESM värden som är [nedbrutna per enhetstyp]/(help/authentication/entitlement-service-monitoring-overview.md#clientless_device_type) när du använder Klientlös, så att olika typer av analyser kan utföras för. Till exempel Roku, AppleTV och Xbox.

Se Fördelar med att använda parametern client_type

Obs! Parametern device_info kommer att ersättas.
deviceUser
Enhetens användaridentifierare.

Obs! Om det används ska deviceUser ha samma värden som i begäran Skapa registreringskod.
appId
Program-ID/namn.

Obs!: device_info ersätter den här parametern. Om det används ska appId ha samma värden som i begäran Skapa registreringskod.

Exempelsvar 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"
    }

Kompatibilitet med medieverifieringsbibliotek

Fältet serializedToken från anropet "Hämta kort medietoken" är en Base64-kodad token som kan verifieras mot Adobe Media Verification Library.

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