DocumentazioneAdobe PassAutenticazione Adobe Pass

(Legacy) Avvia autorizzazione initiate-authorization

Ultimo aggiornamento: 21 agosto 2026
NOTE
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente da Adobe. Non è consentito alcun uso non autorizzato.
IMPORTANT
Assicurati di essere sempre informato sugli ultimi annunci di prodotto per l'autenticazione di Adobe Pass e sulle timeline di disattivazione aggregate nella pagina Annunci di prodotto.
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
Immetti
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 di MVPD.
device_info/

X-Device-Info
Informazioni sul dispositivo di streaming.

Nota: questo parametro POTREBBE essere trasmesso come parametro URL a device_info, ma a causa delle dimensioni potenziali del parametro e delle limitazioni alla lunghezza di un URL 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
Tipo di dispositivo (ad esempio Roku, PC).

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

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
pass-help-authentication