DocumentatieAdobe PassAdobe Pass-verificatie

Autorisatie starten initiate-authorization

Last update: Wed Mar 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
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.
NOTE
REST API-implementatie is beperkt door Draaimechanisme

REST API-eindpunten clientless-endpoints

<reggie_fqdn>:

<sp_fqdn>:

Beschrijving description

Verkrijgt de reactie van de vergunning.

Endpoint
Geroepen
Door
Invoer
Params
HTTP
Methode
Antwoord
HTTP
Antwoord
<sp_fqdn>/api/v1/authorize
Streaming-app

of

Programmeringsservice
1. Aanvrager (verplicht)
2. deviceId (verplicht)
3. bron (verplicht)
4. device_info/X-Device-Info (verplicht)
5. deviceType
6. deviceUser (Verouderd)
7. appId (Verouderd)
8. extra parameters (optioneel)
GET
XML of JSON met machtigingsdetails of foutdetails als dit mislukt. Zie onderstaande voorbeelden.
200 - Succes
403 - Geen succes
Invoerparameter
Beschrijving
aanvrager
De programmeeraanvragerId waarvoor deze verrichting geldig is.
deviceId
Het apparaat-id bytes.
resource
Een koord dat een resourceId (of fragment MRSS) bevat, identificeert de inhoud die door een gebruiker wordt gevraagd en door MVPD vergunningseindpunten wordt erkend.
device_info/

X-Apparaat-Info
Informatie over streaming apparaat.

Opmerking: This MAY BE passed device_info as a URL parameter, but due to the potential size of this parameter and constraints on the length of a GET URL, it should be passed as X-Device-Info in the http header.
\ .
deviceType
Het apparaattype (bijvoorbeeld Roku, PC).

Als deze parameter correct is ingesteld, biedt ESM metriek die uitgesplitst per apparaattype bij gebruik van Clientless, zodat verschillende soorten analyses kunnen worden uitgevoerd voor bijvoorbeeld Roku, AppleTV, Xbox enz.

Zie Voordelen van clientless apparatentype parameter in pasmetriek

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

Opmerking: device_info vervangt deze parameter.
extra parameters
De oproep kan ook optionele parameters bevatten die andere functies mogelijk maken, zoals:

* generic_data - maakt het gebruik van Promotie TempPass

Voorbeeld: generic_data=("email":"email@domain.com")
CAUTION
IP-adres van streaming apparaat

Voor client-aan-server implementaties, wordt het Streaming Apparaat IP Adres impliciet verzonden met deze vraag. Voor server-aan-server implementaties, waar herschrijven De vraag wordt gemaakt door de Dienst van de Programmer en niet het Streaming Apparaat, wordt de volgende kopbal vereist om het Streaming Apparaat IP Adres over te gaan:
code language-none 
X-Forwarded-For : <streaming\_device\_ip>
waar <streaming\_device\_ip> is het openbare IP-adres van het streaming apparaat.


Voorbeeld:
code language-none 
POST /reggie/v1/{req_id}/regcode HTTP/1.1
X-Forwarded-For:203.45.101.20

Samplereactie sample-response

  • Zaak 1: Succes

    • XML:

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

  • JSON:

    code language-json 
    {
  "mvpd": "sampleMvpdId",
  "resource": "sampleResourceId",
  "requestor": "sampleRequestorId",
  "expires": "1348148289000"
}
IMPORTANT
Wanneer de reactie uit een Volmacht MVPD komt, kan het een extra genoemd element omvatten proxyMvpd.

  • Zaak 2: Vergunning geweigerd

    code language-json 
    <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