(Verouderd) Lijst met vooraf gemachtigde bronnen ophalen retrieve-list-of-preauthorized-resources

NOTE
De inhoud op deze pagina wordt alleen ter informatie verstrekt. Voor het gebruik van deze API is een huidige licentie van Adobe vereist. Ongeautoriseerd gebruik is niet toegestaan.
IMPORTANT
Zorg ervoor u over de recentste het productmededelingen van de Authentificatie van Adobe Pass en ontmantelingschronologie wordt geïnformeerd die in de ​ pagina van de Mededelingen van het Product ​ wordt samengevoegd.
NOTE
De implementatie van REST API wordt begrensd door ​ Throttling mechanisme ​

REST API-eindpunten clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

Beschrijving description

Een verzoek aan de Authentificatie van Adobe Pass om de lijst van vooraf geautoriseerde middelen te verkrijgen.

Er zijn twee reeksen APIs: één reeks voor de Streaming App of de Dienst van Programmer en één reeks voor de Tweede SchermApp. Op deze pagina wordt de API voor de Streaming App of Programmer Service beschreven.

Endpoint
Geroepen
door
Invoer
Params
HTTP
Methode
Antwoord
HTTP-respons
<SP_FQDN>/api/v1/preauthorize
Streaming App

of

de Dienst van de Programmer
1. (Verplicht) aanvrager
. deviceId (Verplicht)
. middel (Verplicht)
4. device_info/x-apparaat-Info (Verplicht)
5. deviceType
6. deviceUser (Afgekeurd)
7. appId (Vervangen)
GET
XML of JSON met individuele aan de autorisatie voorafgaande beslissingen of foutdetails. Zie onderstaande voorbeelden.
200 - Succes

400 - het Onjuiste verzoek

401 - ongeoorloofd

405 - Methode niet toegestaan

412 - Voorwaarde ontbrak

500 - Interne Fout van de Server
Invoerparameter
Beschrijving
aanvrager
De programmeeraanvragerId waarvoor deze verrichting geldig is.
deviceId
Het apparaat-id bytes.
resource
Een tekenreeks die een door komma's gescheiden lijst met resourceIds bevat die de inhoud identificeert die toegankelijk kan zijn voor een gebruiker en die wordt herkend door MVPD-autorisatieeindpunten.
device_info/

x-apparaat-Info
Informatie over streaming apparaat.

Nota: Dit KAN device_info als parameter worden overgegaan URL, maar wegens de potentiële grootte van deze parameter en beperkingen op de lengte van een GET URL, ZOU het als x-Apparaat-Info in de kopbal van http moeten worden overgegaan.

zie de volledige details in ​ het overgaan van Apparaat en de Informatie van de Verbinding ​.
deviceType
Het apparaattype (bijvoorbeeld Roku, PC).

als deze parameter correct wordt geplaatst, biedt ESM metriek aan die ​ uitgesplitst per apparatentype ​ zijn wanneer het gebruiken van Clientless, zodat de verschillende types van analyse kunnen worden uitgevoerd bijvoorbeeld, Roku, AppleTV, en Xbox.

zie, ​ voordelen om clientless apparatentype parameter in pas te gebruiken metriek ​

Nota: device_info zal deze parameter vervangen.
deviceUser
De gebruikers-id van het apparaat.
appId
De toepassings-id/-naam.

Nota: device_info vervangt deze parameter.

Samplereactie sample-response

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