DokumentationAdobe PassAdobe Pass-Authentifizierung

Authentifizierungstoken abrufen retrieve-authentication-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

Ruft Authentifizierungs-Token (AuthN) ab.

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

Beispiel:

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

oder

Programmiererdienst
1. Antragsteller (erforderlich)
2. deviceId (Obligatorisch)
3. device_info/X-Device-Info (erforderlich)
4. deviceType (Veraltet)
5. deviceUser (Veraltet)
6. appId (Veraltet)
GET
XML oder JSON mit Authentifizierungsinformationen oder Fehlerdetails, falls nicht erfolgreich.
200 - Erfolg.
404 - Token nicht gefunden
410 - Token abgelaufen
Eingabeparameter
Beschreibung
Anfragender
Die Programmer-Anfrage-ID, für die dieser Vorgang gültig ist.
deviceId
Die Geräte-ID-Bytes.
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.
\ .
deviceType
Der Gerätetyp (z. B. Roku, PC).

Hinweis: Der Parameter device_info ersetzt diesen.
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

Erfolg

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authentication>
         <expires>1601114932000</expires>
         <userId>sampleUserId</userId>
         <mvpd>sampleMvpdId</mvpd>
         <requestor>sampleRequestor</requestor>
    </authentication>

JSON:

    {
         "requestor": "sampleRequestor",
         "mvpd": "sampleMvpdId",
         "userId": "sampleUserId",
         "expires": "1601114932000"
    }

Authentifizierungstoken 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"
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b