(Legacy) Autorisierung einleiten
Letzte Aktualisierung: 5. Mai 2025
- Themen:
- Authentifizierung
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.
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.
Die REST-API-Implementierung wird durch Drosselungsmechanismus)
REST-API-Endpunkte
<REGGIE_FQDN>:
- Produktion - api.auth.adobe.com
- Staging - api.auth-staging.adobe.com
<SP_FQDN>:
- Produktion - api.auth.adobe.com
- Staging - api.auth-staging.adobe.com
Beschreibung
Erhält die Autorisierungsantwort.
Endpunkt
Called
by
by
Eingabe
Parameter
Parameter
HTTP
Methode
Methode
Antwort
HTTP
Antwort
Antwort
<SP_FQDN>/api/v1/authorize
Streaming-App
oder
Programmierer-Service
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)
8. Zusätzliche Parameter (optional)
2. deviceId (obligatorisch)
3. Ressource (obligatorisch)
4. device_info/X-device-info (obligatorisch)
5. deviceType
6. deviceUser (veraltet)
7. appId (veraltet)
8. Zusätzliche Parameter (optional)
GET
XML oder JSON mit Autorisierungsdetails oder Fehlerdetails, wenn nicht erfolgreich. Siehe Beispiele unten.
200 - Erfolg
403 - Kein Erfolg
403 - Kein Erfolg
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
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.
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 für z. B. Roku, AppleTV, Xbox usw. durchgeführt werden können.
Siehe Vorteile des Client-losen Gerätetyp-Parameters in Kennzahlen
Hinweis: Der Parameter wird durch „device_info“ ersetzt.
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 für z. B. Roku, AppleTV, Xbox usw. durchgeführt werden können.
Siehe Vorteile des Client-losen Gerätetyp-Parameters 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.
Hinweis: device_info ersetzt diesen Parameter.
Zusätzliche Parameter
Der Aufruf kann auch optionale Parameter enthalten, die andere Funktionen ermöglichen, z. B.:
* generic_data - Aktiviert die Verwendung von Werbe-TempPass
Beispiel:
* generic_data - Aktiviert die Verwendung von Werbe-TempPass
Beispiel:
generic_data=("email":"email@domain.com")
IP-Adresse des Streaming-Geräts
Bei Client-zu-Server-Implementierungen wird die IP-Adresse des Streaming-Geräts mit diesem Aufruf implizit gesendet. Bei Server-zu-Server-Implementierungen, bei denen der regcode-Aufruf vom Programmierdienst und nicht vom Streaming-Gerät erfolgt, ist der folgende Header erforderlich, um die IP-Adresse des Streaming-Geräts zu übergeben:
Bei Client-zu-Server-Implementierungen wird die IP-Adresse des Streaming-Geräts mit diesem Aufruf implizit gesendet. Bei Server-zu-Server-Implementierungen, bei denen der regcode-Aufruf vom Programmierdienst und nicht vom Streaming-Gerät erfolgt, ist der folgende Header erforderlich, um die IP-Adresse des Streaming-Geräts zu übergeben:
X-Forwarded-For : <streaming\_device\_ip>
wobei
Beispiel :
<streaming\_device\_ip>
die öffentliche IP-Adresse des Streaming-Geräts ist.Beispiel :
POST /reggie/v1/{req_id}/regcode HTTP/1.1
X-Forwarded-For:203.45.101.20
Beispielantwort
-
1. Fall: Erfolg
- XML:
„XML
<?xml version=„1.0“ encoding=„UTF-8“ standalone=„yes“?>
<authorization>
<expires>1348148289000</expires>
<mvpd>sampleMvpdId</mvpd>
<Requestor>sampleRequestorId</Requestor>
<resource>sampleResourceId</resource>
</authorization>
" -
JSON:
{ "mvpd": "sampleMvpdId", "resource": "sampleResourceId", "requestor": "sampleRequestorId", "expires": "1348148289000" }
Wenn die Antwort von einer Proxy-MVPD stammt, kann sie ein zusätzliches Element namens
proxyMvpd
enthalten.-
Fall 2: Genehmigung verweigert
<error> <status>403</status> <message>User not authorized</message> <details>Your subscription package does not include the "ASFAFD" channel. Please go to http://www.ca.ble/upgrade in order to upgrade your subscription.</details> </error>
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b