DokumentationAdobe PassAdobe Pass-Authentifizierung

(Legacy) Liste der vorab autorisierten Ressourcen abrufen

Letzte Aktualisierung: 20. Januar 2025
  • Themen:
  • Authentifizierung
HINWEIS
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.
WICHTIG
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.
HINWEIS
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

Eine Anfrage an die Adobe Pass-Authentifizierung zum Abrufen der Liste der vorab autorisierten Ressourcen.

Es gibt zwei Sätze von APIs: einen Satz für die Streaming-App oder den Programmierer-Service und einen Satz für die Web-App des zweiten Bildschirms. Auf dieser Seite wird die API für die Streaming-App oder den Programmierer-Service beschrieben.

Endpunkt
Called
by
Eingabe
Parameter
HTTP
Methode
Antwort
HTTP
Antwort
<SP_FQDN>/api/v1/preauthorize
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
XML oder JSON mit einzelnen Entscheidungen vor der Autorisierung oder Fehlerdetails. Siehe Beispiele unten.
200 -

400 - Fehlerhafte Anfrage

401 - Nicht autorisiert

405 - Methode nicht zulässig

412 - Voraussetzung fehlgeschlagen

500 - Interner Server-Fehler
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 kommagetrennte Liste von resourceIds enthält, die den Inhalt identifiziert, auf den ein Benutzer zugreifen kann und der 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 device_info ersetzt diesen Parameter.
deviceUser
Die Geräte-Benutzerkennung.
appId
Die Anwendungs-ID/-name.

Hinweis: device_info ersetzt diesen Parameter.

Beispielantwort

XML:

HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/xml; charset=utf-8

<resources>
  <resource>
    <id>TestStream1</id>
    <authorized>true</authorized>
  </resource>
  <resource>
    <id>TestStream2</id>
    <authorized>false</authorized>
    <error>
      <status>403</status>
      <code>authorization_denied_by_mvpd</code>
      <message>User not authorized</message>
      <details>Your subscription package does not include the "TestStream3" channel.</details>
      <helpUrl>https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes</helpUrl>
      <trace>0453f8c8-167a-4429-8784-cd32cfeaee58</trace>
      <action>none</action>
    </error>
  </resource>
</resources>

JSON:

HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/json; charset=utf-8

{
   "resources" : [
        {
            "id" : "TestStream1",
            "authorized" : true
        },
        {
            "id" : "TestStream3",
            "authorized" : false,
            "error" : {
               "status" : 403,
               "code" : "authorization_denied_by_mvpd",
               "message" : "User not authorized",
               "details" : "Your subscription package does not include the "TestStream3" channel.",
               "helpUrl" : "https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes",
               "trace" : "0453f8c8-167a-4429-8784-cd32cfeaee58",
               "action" : "none"
            }
        }
    ]
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b