Recupera profilo per mvpd specifico retrieve-profile-for-specific-mvpd

IMPORTANT
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.
IMPORTANT
L'implementazione REST API V2 è limitata dalla documentazione del meccanismo di limitazione.

Richiesta request

HTTP
percorso
/api/v2/{serviceProvider}/profiles/{mvpd}
metodo
GET
Parametri percorso
serviceProvider
Identificatore univoco interno associato al provider di servizi durante il processo di onboarding.
obbligatorio
mvpd
Identificatore univoco interno associato al provider di identità durante il processo di onboarding.
obbligatorio
Intestazioni
Autorizzazione
La generazione del payload del token Bearer è descritta nella documentazione di Registrazione client dinamica.
obbligatorio
AP-Device-Id
La generazione del payload dell'identificatore del dispositivo è descritta nella documentazione di AP-Device-Identifier.
obbligatorio
X-Device-Info
La generazione del payload di informazioni sul dispositivo è descritta nella documentazione di X-Device-Info.

Si consiglia vivamente di utilizzarlo sempre quando la piattaforma del dispositivo dell’applicazione consente di fornire esplicitamente valori validi.

Se fornito, il backend di autenticazione di Adobe Pass unirà in modo esplicito i valori con quelli estratti in modo implicito (per impostazione predefinita).

Se non viene fornito, il backend di autenticazione Adobe Pass utilizzerà i valori estratti in modo implicito (per impostazione predefinita).
obbligatorio
X-Forwarded-For
Indirizzo IP del dispositivo di streaming.

Si consiglia vivamente di utilizzarlo sempre per le implementazioni server-to-server, in particolare quando la chiamata viene effettuata dal servizio del programmatore anziché dal dispositivo di streaming.

Per le implementazioni client-server, l’indirizzo IP del dispositivo di streaming viene inviato in modo implicito.
facoltativo
Adobe-Subject-Token
La generazione del payload Single Sign-On per il metodo Platform Identity è descritta nella documentazione di Adobe-Subject-Token.

Per ulteriori dettagli sui flussi abilitati per il Single Sign-On che utilizzano un'identità di piattaforma, fare riferimento alla documentazione Single Sign-On che utilizza flussi di identità di piattaforma.
facoltativo
AD-Service-Token
La generazione del payload Single Sign-On per il metodo Service Token è descritta nella documentazione di AD-Service-Token.

Per ulteriori dettagli sui flussi abilitati per il Single Sign-On tramite un token di servizio, fare riferimento alla documentazione Single Sign-On tramite flussi di token di servizio.
facoltativo
AP-Partner-Framework-Status
La generazione del payload Single Sign-On per il metodo Partner è descritta nella documentazione di AP-Partner-Framework-Status.

Per ulteriori dettagli sui flussi abilitati per il Single Sign-On tramite un partner, fare riferimento alla documentazione Single Sign-On tramite flussi partner.
facoltativo
AP-TempPass-Identity
La generazione del payload dell'identificatore univoco utente è descritta nella documentazione di AP-TempPass-Identity.
facoltativo
Accetta
Tipo di supporto accettato dall'applicazione client.

Se specificato, deve essere application/json.
facoltativo
User-Agent
Agente utente dell’applicazione client.
facoltativo

Risposta response

Codice
Testo
Descrizione
200
OK
Il corpo della risposta contiene una mappa di profili validi, che può essere vuota.
400
Richiesta non valida
Richiesta non valida. Il client deve correggere la richiesta e riprovare. Il corpo della risposta può contenere informazioni di errore conformi alla documentazione di Codici di errore avanzati.
401
Non autorizzato
Il token di accesso non è valido, il client deve ottenere un nuovo token di accesso e riprovare. Per ulteriori dettagli, consulta la documentazione di Registrazione client dinamica.
405
Metodo non consentito
Metodo HTTP non valido. Il client deve utilizzare un metodo HTTP consentito per la risorsa richiesta e riprovare. Per ulteriori dettagli, consulta la sezione Richiesta.
500
Errore interno del server
Si è verificato un problema sul lato server. Il corpo della risposta può contenere informazioni di errore conformi alla documentazione di Codici di errore avanzati.

Completato success

Intestazioni
Stato
200
obbligatorio
Content-Type
application/json
obbligatorio
Corpo
profili

JSON contenente una mappa di coppie chiave-valore.

L’elemento chiave è definito dal seguente valore:

table 0-row-3 1-row-3 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff layout-auto html-authored
Valore
mvpd Identificatore univoco interno associato al provider di identità durante il processo di onboarding. obbligatorio

L'elemento value è definito dai seguenti attributi:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 9-bgcolor-deebff 13-bgcolor-deebff 17-bgcolor-deebff 21-bgcolor-deebff layout-auto html-authored
Attributo
notBefore Il timestamp prima del quale il profilo non è valido. obbligatorio
notAfter Il timestamp dopo il quale il profilo non è valido. obbligatorio
emittente

Entità a cui appartiene il profilo.

I valori possibili sono:

  • mvpd (ad esempio, Spectrum, Cablevision e così via)
    Il profilo è stato creato in seguito a: autenticazione di base, Single Sign-On tramite l'identità della piattaforma o Single Sign-On tramite il token di servizio.
  • Adobe
    Il profilo è stato creato in seguito a: accesso danneggiato, accesso temporaneo.
  • Apple
    Il profilo è stato creato in seguito a: single sign-on con il partner Apple.
obbligatorio
tipo

Tipo del profilo.

I valori possibili sono:

  • regolare
    Il profilo è stato creato come risultato di: autenticazione di base.
  • danneggiato
    Il profilo è stato creato in seguito a: accesso danneggiato.
  • temporaneo
    Il profilo è stato creato in seguito a: accesso temporaneo.
  • appleSSO
    Il profilo è stato creato in seguito a: single sign-on con Apple partner.
  • platformSSO
    Il profilo è stato creato come risultato di: single sign-on utilizzando l'identità della piattaforma.
  • serviceTokenSSO
    Il profilo è stato creato in seguito a: Single Sign-On utilizzando un token di servizio.
obbligatorio
attributi

L’elenco degli attributi dei metadati utente.

Questi attributi possono essere:

  • Obbligatorio, come "userId"
  • Non obbligatorio, come "zip", "familyId", "maxRating", ecc.

I valori per gli attributi possono essere:

  • semplice
  • list
  • mappa
obbligatorio
obbligatorio

Errore error

Intestazioni
Stato
400, 401, 405, 500
obbligatorio
Content-Type
application/json
obbligatorio
Corpo
errore
L'errore fornisce informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.
obbligatorio

Esempi samples

1. Recupera tutti i profili autenticati esistenti e validi ottenuti tramite l’autenticazione di base per mvpd specifici

Richiesta
code language-json
GET /api/v2/REF30/profiles/Spectrum

Authorization: Bearer ....
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
X-Device-Info ....
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 14.5 like Mac OS X; en_US)
Risposta
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "profiles" : {
        "Spectrum" : {
            "notBefore" : 1623943955,
            "notAfter" : 1623951155,
            "issuer" : "Spectrum",
            "type" : "regular",
            "attributes" : {
                "userId" : {
                    "value" : "BASE64_value_userId",
                    "state" : "plain"
                },
                "householdId" : {
                    "value" : "BASE64_value_householdId",
                    "state" : "plain"
                },
                "zip" : {
                    "value" : "BASE64_value_zip",
                    "state" : "enc"
                },
                "parental-controls" : {
                    "value" : BASE64_value_parental-controls,
                    "state" : "plain"
                }
            }
        }
     }
}

2. Recupera tutti i profili autenticati esistenti e validi, inclusi quelli ottenuti tramite l’autenticazione single sign-on utilizzando il metodo Service Token per mvpd specifico

Richiesta
code language-json
GET /api/v2/REF30/profiles/AdobeShibboleth

Authorization: Bearer ....
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
X-Device-Info ....
AD-Service-Token : eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJkZDNmYWIyN2NmMjg0ZmU2ZWU0ZDY3ZmExZjY4MzE3YyIsImlzcyI6IkFkb2JlIiw.....
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 14.5 like Mac OS X; en_US)
Risposta
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
   "profiles": {
      "AdobeShibboleth": {
         "notBefore": 1748073636999,
         "notAfter": 1748105173000,
         "issuer": "AdobeShibboleth",
         "type": "serviceTokenSSO",
         "attributes": {
            "upstreamUserID": {
               "value": "AAdzZWNyZXQxydCkywfPBl0KExk8OWhdbUBVDDJBttfKD7RAcRlc32Pbuwd1...",
               "state": "plain"
            },
            "userID": {
               "value": "AAdzZWNyZXQxydCkywfPBl0KExk8OWhdbUBVDDJBttfKD7RAcRlc32Pbuwd14aTV....",
               "state": "plain"
            },
            "mvpd": {
               "value": "AdobeShibboleth",
               "state": "plain"
            }
         }
      }
   }
}

3. Recupera tutti i profili autenticati esistenti e validi, inclusi quelli ottenuti tramite l’autenticazione single sign-on utilizzando il metodo Platform Identity per mvpd specifico

Richiesta
code language-json
GET /api/v2/REF30/profiles/AdobePass_SMI

Authorization: Bearer ....
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
X-Device-Info ....
Adobe-Subject-Token : eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIyMmM4MDU1MjEzMDIwYzhmZGYzOGZkMTI1YWViMzUzYSIsImlzcyI6....
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 14.5 like Mac OS X; en_US)
Risposta
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
   "profiles": {
      "AdobePass_SMI": {
         "notBefore": 1724337476000,
         "notAfter": 1724345252000,
         "issuer": "AdobePass_SMI",
         "type": "platformSSO",
         "attributes": {
            "upstreamUserID": {
               "value": "38524bdc3d1caac0b3e139003ea0954e15ad9648",
               "state": "plain"
            },
            "userID": {
               "value": "38524bdc3d1caac0b3e139003ea0954e15ad9648",
               "state": "plain"
            },
            "mvpd": {
               "value": "AdobePass_SMI",
               "state": "plain"
            }
         }
      }
   }
}

4. Recuperare le informazioni sul profilo per il passaggio temporaneo

Richiesta
code language-json
GET /api/v2/REF30/profiles/TempPass_TEST40

Authorization: Bearer ....
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
X-Device-Info ....
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 14.5 like Mac OS X; en_US)
Risposta - Disponibile
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "profiles": {
        "TempPass_TEST40": {
            "notBefore": 1697718650206,
            "notAfter": 1697718710206,
            "issuer": "Adobe",
            "type": "temporary",
            "attributes": {
                "expiration_date": {
                    "value": 1697718710206,
                    "state": "plain"
                },
                "userID": {
                    "value": "temppass_0bdf451aa9c8fa60e80f6b99ab48310c73b480f1",
                    "state": "plain"
                }
            }
        }
    }
}
Risposta - Avviata
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "profiles": {
        "TempPass_TEST40": {
            "notBefore": 1697719584085,
            "notAfter": 1697719704085,
            "issuer": "Adobe",
            "type": "temporary",
            "attributes": {
                "expiration_date": {
                    "value": 1697719704085,
                    "state": "plain"
                },
                "userID": {
                    "value": "temppass_0bdf451aa9c8fa60e80f6b99ab48310c73b480f1",
                    "state": "plain"
                }
            }
        }
    }
}
Risposta - Scaduta
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "status": 200,
    "code": "temppass_expired",
    "message": "TempPass has expired.",
    "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=it",
    "action": "none"
}
Risposta - Configurazione non valida
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "status": 500,
    "code": "temppass_invalid_configuration",
    "message": "TempPass configuration is invalid.",
    "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=it",
    "action": "none"
}

5. Recuperare le informazioni sul profilo per il pass temporaneo promozionale

Richiesta
code language-json
GET /api/v2/REF30/profiles/flexibleTempPass

Authorization: Bearer ....
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
X-Device-Info ....
AP-TempPass-Identity: eyJlbWFpbCI6ImZvb0BiYXIuY29tIn0=
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 14.5 like Mac OS X; en_US)
Risposta - Disponibile
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "profiles": {
        "flexibleTempPass": {
            "notBefore": 1697719042666,
            "notAfter": 1697719102666,
            "issuer": "Adobe",
            "type": "temporary",
            "attributes": {
                "remaining_resources": {
                    "value": 5,
                    "state": "plain"
                },
                "used_assets": {
                    "value": 0,
                    "state": "plain"
                },
                "expiration_date": {
                    "value": 1697719102666,
                    "state": "plain"
                },
                "userID": {
                    "value": "temppass_0bdf451aa9c8fa60e80f6b99ab48310c73b480f1",
                    "state": "plain"
                }
            }
        }
    }
}
Risposta - Avviata
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "profiles": {
        "flexibleTempPass": {
            "notBefore": 1697720528524,
            "notAfter": 1697720588524,
            "issuer": "Adobe",
            "type": "temporary",
            "attributes": {
                "remaining_resources": {
                    "value": 1,
                    "state": "plain"
                },
                "used_assets": {
                    "value": [
                        "res04",
                        "res02",
                        "res03",
                        "res01"
                    ],
                    "state": "plain"
                },
                "expiration_date": {
                    "value": 1697720528524,
                    "state": "plain"
                },
                "userID": {
                    "value": "temppass_0bdf451aa9c8fa60e80f6b99ab48310c73b480f1",
                    "state": "plain"
                }
            }
        }
    }
}
Risposta - Scaduta
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "status": 200,
    "code": "temppass_expired",
    "message": "TempPass has expired.",
    "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=it",
    "action": "none"
}
Risposta - Utilizzata
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "decisions": [
        {
            "authorized": false,
            "error": {
                "status": 200,
                "code": "temppass_max_resources_exceeded",
                "message": "Flexible TempPass maximum resources exceeded.",
                "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=it",
                "action": "none"
            }
        }
    ]
}
Risposta - Configurazione non valida
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "status": 500,
    "code": "temppass_invalid_configuration",
    "message": "TempPass configuration is invalid.",
    "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=it",
    "action": "none"
}
Risposta - Identità non valida
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "status": 400,
    "code": "temppass_invalid_identity",
    "message": "TempPass is not available for the specified identity.",
    "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=it",
    "action": "none"
}

6. Recuperare le informazioni sul profilo per mvpd danneggiati

Richiesta
code language-json
GET /api/v2/REF30/profiles/degradedMvpd

Authorization: Bearer ....
AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
X-Device-Info ....
Accept: application/json
User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 14.5 like Mac OS X; en_US)
Risposta - Degradazione AuthNAll
code language-json
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "profiles": {
        "degradedMvpd": {
            "notBefore": 1697719042666,
            "notAfter": 1697719102666,
            "issuer": "Adobe",
            "type": "degraded",
            "attributes":
                "userID": {
                    "value": "95cf93bcd183214a0bdf451aa9c8fa60e80f6b99ab48310c73b480f1",
                    "state": "plain"
                }
            }
        }
    }
}

Nota: 95cf93bcd183214a è un prefisso specifico per la degradazione.

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b