DokumentationAdobe PassAdobe Pass-Authentifizierung

Short Media Token abrufen obtain-short-media-token

Last update: Wed Mar 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
Der Inhalt dieser Seite dient nur Informationszwecken. Für die Verwendung dieser API ist eine aktuelle Lizenz von Adobe erforderlich. Eine unbefugte Anwendung ist nicht zulässig.
NOTE
Die REST-API-Implementierung wird durch Drosselmechanismus

REST-API-Endpunkte clientless-endpoints

<reggie_fqdn>:

<sp_fqdn>:

Beschreibung description

Erhält ein Short Media Token.

Endpunkt
aufgerufen
von
Eingabe
Parameter
HTTP
Methode
Reaktion
HTTP
Reaktion
<sp_fqdn>/api/v1/mediatoken

oder

<sp_fqdn>/api/v1/tokens/media

Beispiel:

<sp_fqdn>/api/v1/tokens/media
Streaming-App

oder

Programmiererdienst
1. Antragsteller (erforderlich)
2. deviceId (Obligatorisch)
3. resource (erforderlich)
4. device_info/X-Device-Info (erforderlich)
5. deviceType
6. deviceUser (Veraltet)
7. appId (Veraltet)
GET
XML oder JSON, die ein Base64-kodiertes Medien-Token oder Fehlerdetails enthalten, falls nicht erfolgreich.
200 - Erfolg
403 - Kein Erfolg
Eingabeparameter
Beschreibung
Anfragender
Die Programmer-Anfrage-ID, für die dieser Vorgang gültig ist.
deviceId
Die Geräte-ID-Bytes.
resource
Eine Zeichenfolge, die eine resourceId (oder ein MRSS-Fragment) enthält, den von einem Benutzer angeforderten Inhalt identifiziert und von MVPD-Autorisierungsendpunkten erkannt wird.
device_info/

X-Device-Info
Informationen zum Streaming-Gerät.

Hinweis: Dieser Parameter kann als URL-Parameter an device_info übergeben werden. Aufgrund der potenziellen Größe dieses Parameters und der Längenbeschränkungen einer GET-URL sollte er jedoch als X-Device-Info in der HTTP-Kopfzeile übergeben werden.

Weitere Informationen finden Sie unter Weitergeben von Geräte- und Verbindungsinformationen.
deviceType
Der Gerätetyp (z. B. Roku, PC).

Wenn dieser Parameter korrekt festgelegt ist, bietet ESM Metriken an, die [aufgeschlüsselt nach Gerätetyp]/(help/authentication/entitlement-service-monitoring-overview.md#clientless_device_type) bei der Verwendung von ClientLess, sodass verschiedene Arten der Analyse durchgeführt werden können. Beispiel: Roku, AppleTV und Xbox.

Siehe Vorteile der Verwendung des Client-losen DeviceType-Parameters

Hinweis: Der Parameter device_info ersetzt diesen Parameter.
deviceUser
Die Benutzer-ID des Geräts.

Hinweis: Bei Verwendung von sollte deviceUser dieselben Werte wie im Registrierungscode erstellen -Anfrage.
appId
Die Anwendungs-ID/der Name.

Hinweis: Der Parameter device_info ersetzt diesen. Falls verwendet, appId sollte dieselben Werte wie im Registrierungscode erstellen -Anfrage.

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

Kompatibilität der Medienverifizierungsbibliothek

Das Feld serializedToken vom Aufruf "Short Media Token abrufen"ist ein Base64-kodiertes Token, das mit der Adobe Medien Verification Library verifiziert werden kann.

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