Documentatie Adobe Pass Adobe Pass-verificatie

(Verouderd) Gebruikersmetagegevens

29 januari 2025

Onderwerpen:
Authenticatie

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.

IMPORTANT

Zorg ervoor u over de recentste het productmededelingen van de Authentificatie van Adobe Pass en ontmantelingschronologie wordt geïnformeerd die in de pagina van de Mededelingen van het Productwordt samengevoegd.

NOTE

De implementatie van REST API wordt begrensd door Throttling mechanisme

REST API-eindpunten

<REGGIE_FQDN>:

Productie - api.auth.adobe.com
Het opvoeren - api.auth-staging.adobe.com

<SP_FQDN>:

Productie - api.auth.adobe.com
Het opvoeren - api.auth-staging.adobe.com

Beschrijving

Haal metagegevens op die MVPD over de geverifieerde gebruiker heeft gedeeld.

Endpoint

Geroepen
door

Invoer
Params

HTTP
Methode

Antwoord

HTTP-respons

<SP_FQDN>/api/v1/tokens/usermetadata

Streaming App

of

de Dienst van de Programmer

1. aanvrager
2. deviceId (Verplicht)
. device_info/x-apparaat-Info (Verplicht)
4. deviceType
5. deviceUser (Afgekeurd)
6. appId (afgekeurd)

GET

XML of JSON bevatten gebruikersmetagegevens of foutgegevens als dit niet lukt.

200 - Succes

404 - Geen metagegevens gevonden

412 - Ongeldige token AuthN (bijvoorbeeld verlopen token)

Invoerparameter

Beschrijving

aanvrager

De programmeeraanvragerId waarvoor deze verrichting geldig is.

deviceId

Het apparaat-id bytes.

device_info/

X-Apparaat-Info

Informatie over streaming apparaat.

Nota: Dit KAN device_info als parameter worden overgegaan URL, maar wegens de potentiële grootte van deze parameter en beperkingen op de lengte van een GET URL, ZOU het als x-Apparaat-Info in de HTTP- kopbal moeten worden overgegaan.

zie de volledige details in het overgaan Apparaat en de Informatie van de Verbinding.

deviceType

Het apparaattype (bijvoorbeeld Roku, PC).

Als deze parameter correct wordt geplaatst, biedt ESM metriek aan die uitgesplitst per apparatentypewanneer het gebruiken van Clientless zijn, zodat de verschillende soorten analyse voor bijvoorbeeld Roku, AppleTV, Xbox enz. kunnen worden uitgevoerd.

Zie Voordelen om clientless apparatentype parameter in de metriek van de Pas te gebruiken

Nota: vervangt device_info deze parameter.

deviceUser

De herkenningsteken van de apparatengebruiker.

Nota: Indien gebruikt, deviceUser zou de zelfde waarden moeten hebben zoals in creeer de verzoek van de Code van de Registratie.

appId

De toepassings-id/-naam.

Nota: vervangt device_info deze parameter. Indien gebruikt, appId zou de zelfde waarden moeten hebben zoals in creeer de verzoek van de Code van de Registratie.

NOTE

De informatie van gebruikersmeta-gegevens zou beschikbaar moeten zijn nadat de authentificatiestroom is voltooid, maar kan op de toestemmingsstroom, afhankelijk van MVPD en het meta-gegevenstype worden bijgewerkt.

Samplereactie

Na een geslaagde aanroep zal de server reageren met een XML- (standaard) of JSON-object met een structuur die vergelijkbaar is met de hieronder weergegeven structuur:

    {
        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"]
              }
    }

Aan de basis van het object bevinden zich drie knooppunten:

bijgewerkt: specificeert een timestamp van UNIX die de laatste tijd vertegenwoordigt de meta-gegevens werden bijgewerkt. Dit bezit zal aanvankelijk door de server worden geplaatst wanneer het produceren van de meta-gegevens tijdens de authentificatiefase. Volgende aanroepen (nadat de metagegevens zijn bijgewerkt) resulteren in een verhoogde tijdstempel.
gegevens: bevat de daadwerkelijke meta-gegevenswaarden.
gecodeerd: een serie die van de gecodeerde eigenschappen een lijst maken. Om een specifieke meta-gegevenswaarde te decrypteren, moet de programmeur een Base64 decoderen op de meta-gegevens dan toepassen een decryptie van RSA op de resulterende waarde, gebruikend het eigen privé sleutel (de Adobe codeert de meta-gegevens op de server gebruikend het openbare certificaat van de Programmer).

Bij een fout retourneert de server een XML- of JSON-object dat een gedetailleerd foutbericht opgeeft.

Voor meer informatie, zie Metagegevens van de Gebruiker.

Terug naar REST API Reference

recommendation-more-help