DokumentationAdobe PassAdobe Pass-Authentifizierung

(Legacy) Autorisierungs-Token abrufen retrieve-authorization-token

Last update: Mon Nov 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
Der Inhalt dieser Seite dient nur zu Informationszwecken. Die Verwendung dieser API erfordert eine aktuelle Lizenz von Adobe. Eine unbefugte Nutzung ist nicht zulässig.
IMPORTANT
Achten Sie darauf, über die neuesten Ankündigungen zu Produkten der Adobe Pass-Authentifizierung und Stilllegungszeitpläne auf der Seite Produktankündigungen auf dem Laufenden zu bleiben.
NOTE
Die REST-API-Implementierung wird durch Drosselungsmechanismus) ​

REST-API-Endpunkte clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

Beschreibung description

Ruft das Autorisierungs-Token (AuthZ) ab.

Endpunkt
Called
by
Eingabe
Parameter
HTTP
Methode
Antwort
HTTP
Antwort
<SP_FQDN>/api/v1/tokens/authz

Beispiel:

<SP_FQDN>/api/v1/tokens/authz
Streaming-App

oder

Programmierer-Service
​1. Antragsteller (obligatorisch)
2. deviceId (obligatorisch)
3. Ressource (obligatorisch)
4. device_info/X-device-info (obligatorisch)
5. deviceType
6. deviceUser (veraltet)
7. appId (veraltet)
GET
​1. Erfolg
2. Authentifizierungstoken-
Nicht gefunden oder abgelaufen:
XML-
für Auth-Token nicht gefunden
3. Autorisierungs-Token-
Nicht gefunden:
XML-
4. Autorisierungs-Token-
Abgelaufen:
XML-Erklärung
200 - Erfolg
412 - Kein AuthN

404 - Kein AuthZ

410 - AuthZ abgelaufen
Eingabeparameter
Beschreibung
Antragsteller
Die RequestorId des Programmierers, für den dieser Vorgang gültig ist.
deviceId
Die Geräte-ID-Bytes.
Ressource
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 zu Streaming-Geräten.

Hinweis: Dies kann als URL-Parameter an device_info übergeben werden, sollte jedoch aufgrund der potenziellen Größe dieses Parameters und der Längenbeschränkungen für eine GET-URL als X-Device-Info im HTTP-Header übergeben werden.

Vollständige Details finden Sie unter Übergeben von Geräte- und Verbindungsinformationen.
deviceType
Der Gerätetyp (z. B. Roku, PC).

Wenn dieser Parameter richtig festgelegt ist, bietet ESM Metriken an, die nach Gerätetyp aufgeschlüsselt) ​ Verwendung von Clientless sind, sodass verschiedene Arten der Analyse durchgeführt werden können, z. B. Roku, AppleTV und Xbox.

Siehe Vorteile der Verwendung von Client-losen Gerätetypparametern in Kennzahlen ​

Hinweis: der Parameter wird durch „device_info“ ersetzt.
deviceUser
Die Geräte-Benutzerkennung.
appId
Die Anwendungs-ID/-name.

Hinweis: device_info ersetzt diesen Parameter.

Beispielantwort response

Erfolg

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authorization>
        <expires>1348148289000</expires>
        <mvpd>sampleMvpdId</mvpd>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <proxyMvpd>sampleProxyMvpdId</proxyMvpd>
    </authorization>

JSON:

    {
        "mvpd": "sampleMvpdId",
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348148289000",
        "proxyMvpd": "sampleProxyMvpdId"
    }

Authentifizierungstoken nicht gefunden oder abgelaufen:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>412</status>
        <message>User not authenticated</message>
    </error>

JSON:

    {
        "status": 412,
        "message": "User not authenticated",
        "details": null
    }

Autorisierungs-Token nicht gefunden:

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",
        "details": null
    }

Autorisierungs-Token abgelaufen:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>410</status>
        <message>Gone</message>
    </error>

JSON:

    {
        "status": 410,
        "message": "Gone",
        "details": null
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b