DocumentazioneAdobe PassAutenticazione Adobe Pass

Avvia autorizzazione initiate-authorization

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente di Adobe. Non è consentito alcun uso non autorizzato.
NOTE
L'implementazione REST API è limitata dal meccanismo di limitazione

Endpoint REST API clientless-endpoints

<FQDN_REGGIE>:

<SP_FQDN>:

Descrizione description

Ottiene la risposta di autorizzazione.

Endpoint
Chiamato
da
Input
Parametri
Metodo HTTP
Risposta
HTTP
Risposta
<SP_FQDN>/api/v1/authorize
Servizio programmatore

o

app in streaming
1. richiedente (obbligatorio)
2. deviceId (obbligatorio)
3. resource (obbligatorio)
4. device_info/X-Device-Info (obbligatorio)
5. tipoDispositivo
6. deviceUser (obsoleto)
7. appId (obsoleto)
8. parametri aggiuntivi (facoltativo)
GET
XML o JSON contenente i dettagli di autorizzazione o di errore se l’operazione non ha esito positivo. Vedi gli esempi di seguito.
200 - Operazione riuscita
403 - Nessuna operazione riuscita
Parametro di input
Descrizione
richiedente
ID richiedente del programmatore per il quale è valida questa operazione.
deviceId
Byte ID dispositivo.
resource
Una stringa che contiene un resourceId (o frammento MRSS), identifica il contenuto richiesto da un utente ed è riconosciuta dagli endpoint di autorizzazione MVPD.
device_info/

X-Device-Info
Informazioni sul dispositivo di streaming.

Nota: questo parametro POTREBBE essere trasmesso come parametro URL_device, ma a causa delle dimensioni potenziali del parametro e delle limitazioni alla lunghezza di un URL di GET, DOVREBBE essere trasmesso come X-Device-Info nell'intestazione http.

Visualizza tutti i dettagli in Trasmissione delle informazioni sul dispositivo e sulla connessione.
tipoDispositivo
Il tipo di dispositivo (ad esempio, Roku, PC).

Se questo parametro è impostato correttamente, ESM offre metriche suddivise per tipo di dispositivo quando si utilizza senza client, in modo che possano essere eseguiti diversi tipi di analisi, ad esempio per Roku, AppleTV, Xbox ecc.

Vedere Vantaggi del parametro relativo al tipo di dispositivo senza client nelle metriche di passaggio

Nota: il parametro device_info verrà sostituito.
utenteDispositivo
L’identificatore utente del dispositivo.
appId
ID/nome dell’applicazione.

Nota: device_info sostituisce questo parametro.
parametri aggiuntivi
La chiamata può inoltre contenere parametri facoltativi che abilitano altre funzionalità come:

* generic_data - abilita l'utilizzo di Promotional TempPass

Esempio: generic_data=("email":"email@domain.com")
CAUTION
Indirizzo IP dispositivo di streaming

Per le implementazioni client-server, l'indirizzo IP del dispositivo di streaming viene inviato implicitamente con questa chiamata. Per le implementazioni server-to-server in cui la chiamata regcode viene effettuata dal servizio Programmatore e non dal dispositivo di streaming, è necessaria la seguente intestazione per passare l'indirizzo IP del dispositivo di streaming:
code language-none 
X-Forwarded-For : <streaming\_device\_ip>
dove <streaming\_device\_ip> è l'indirizzo IP pubblico del dispositivo di streaming.


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

Risposta di esempio sample-response

  • Caso 1: operazione riuscita

    • XML:

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

  • JSON:

    code language-json 
    {
  "mvpd": "sampleMvpdId",
  "resource": "sampleResourceId",
  "requestor": "sampleRequestorId",
  "expires": "1348148289000"
}
IMPORTANT
Quando la risposta proviene da un MVPD proxy, può includere un elemento aggiuntivo denominato proxyMvpd.

  • Caso 2: autorizzazione negata

    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