Documentazione Adobe Pass Autenticazione Adobe Pass

Metadati utente user-metadata

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Autenticazione

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

<REGGIE_FQDN>:

Produzione - api.auth.adobe.com
Staging - api.auth-staging.adobe.com

<SP_FQDN>:

Produzione - api.auth.adobe.com
Staging - api.auth-staging.adobe.com

Descrizione description

Recupera i metadati condivisi da MVPD sull’utente autenticato.

Endpoint

Chiamato
da

Input
Parametri

Metodo HTTP

Risposta

HTTP
Risposta

<SP_FQDN>/api/v1/tokens/usermetadata

Servizio programmatore

o

app in streaming

1. richiedente
2. deviceId (obbligatorio)
3. device_info/X-Device-Info (obbligatorio)
4. deviceType
5. deviceUser (obsoleto)
6. appId (obsoleto)

GET

XML o JSON contenente i metadati dell’utente o i dettagli dell’errore in caso di esito negativo.

200 - Operazione completata

404 - Metadati non trovati

412 - Token AuthN non valido (ad esempio, token scaduto)

Parametro di input

Descrizione

richiedente

ID richiedente del programmatore per il quale è valida questa operazione.

deviceId

Byte ID dispositivo.

device_info/

X-Device-Info

Informazioni dispositivo di streaming.

Nota: È possibile che vengano passate informazioni_dispositivo come parametro URL, ma a causa delle dimensioni potenziali di questo parametro e delle limitazioni alla lunghezza di un URL di GET, DOVREBBE essere passato come informazioni-X-Device nell'intestazione http.

Vedere i dettagli completi 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 Clientless, in modo che possano essere eseguiti diversi tipi di analisi per esempio Roku, AppleTV, Xbox ecc.

Vedere Vantaggi dell'utilizzo del parametro del tipo di dispositivo senza client nelle metriche Pass

Nota: device_info sostituisce questo parametro.

utenteDispositivo

Identificatore utente del dispositivo.

Nota: se utilizzato, deviceUser deve avere gli stessi valori della richiesta Crea codice di registrazione.

appId

ID/nome dell’applicazione.

Nota: device_info sostituisce questo parametro. Se utilizzato, appId deve avere gli stessi valori della richiesta Crea codice di registrazione.

NOTE

Le informazioni sui metadati dell’utente devono essere disponibili al termine del flusso di autenticazione, ma possono essere aggiornate in base al flusso di autorizzazione, a seconda dell’MVPD e del tipo di metadati.

Risposta di esempio sample-response

Dopo una chiamata corretta, il server risponderà con un oggetto XML (predefinito) o JSON con una struttura simile a quella presentata di seguito:

    {
        updated: 1334243471,
        encrypted: ["encryptedProp"],
        data: {
              zip: ["12345", "34567"],
              maxRating: {
                  "MPAA": "PG-13",
                  "VCHIP": "TV-Y",
                  "URL": "http://exam.pl/e/manage/ratings"
                         },
              householdID: "3456",
              userID: "BgSdasfsdk23/dsaf3+saASesadgfsShggssd=",
              channelID: ["channel-1", "channel-2"]
              }
    }

Nella radice dell'oggetto ci saranno tre nodi:

updated: specifica un timestamp UNIX che rappresenta l'ultimo aggiornamento dei metadati. Questa proprietà verrà impostata inizialmente dal server durante la generazione dei metadati durante la fase di autenticazione. Le chiamate successive (dopo l’aggiornamento dei metadati) genereranno un timestamp incrementato.
dati: contiene i valori metadati effettivi.
encrypted: matrice che elenca le proprietà crittografate. Per decrittografare un valore di metadati specifico, il programmatore deve eseguire una decodifica Base64 sui metadati e quindi applicare una decrittografia RSA sul valore risultante, utilizzando la propria chiave privata (ad Adobe, crittografa i metadati sul server utilizzando il certificato pubblico del programmatore).

In caso di errore, il server restituirà un oggetto XML o JSON che specifica un messaggio di errore dettagliato.

Per ulteriori informazioni, vedere Metadati utente.

Torna a Riferimento API REST

recommendation-more-help

3f5e655c-af63-48cc-9769-2b6803cc5f4b