DocumentatieAdobe PassAdobe Pass-verificatie

Metagegevens gebruiker user-metadata

Last update: Wed Mar 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
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.
NOTE
REST API-implementatie is beperkt door Draaimechanisme

REST API-eindpunten clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

Beschrijving description

Haal meta-gegevens terug die MVPD over de voor authentiek verklaarde gebruiker deelde.

Endpoint
Geroepen
Door
Invoer
Params
HTTP
Methode
Antwoord
HTTP
Antwoord
<SP_FQDN>/api/v1/tokens/usermetadata
Streaming-app

of

Programmeringsservice
1. aanvrager
2. deviceId (verplicht)
3. device_info/X-Device-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.

Opmerking: DIT KAN device_info als parameter URL worden overgegaan, 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 Gegevens van apparaat en verbinding doorgeven.
deviceType
Het apparaattype (bijvoorbeeld Roku, PC).

Als deze parameter correct is ingesteld, biedt ESM metriek die uitgesplitst per apparaattype bij gebruik van Clientless, zodat verschillende soorten analyses kunnen worden uitgevoerd voor bijvoorbeeld Roku, AppleTV, Xbox enz.

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

Opmerking: De device_info vervangt deze parameter.
deviceUser
De gebruikers-id van het apparaat.

Opmerking: Indien gebruikt, deviceUser moeten dezelfde waarden hebben als in de Registratiecode maken verzoek.
appId
De toepassings-id/-naam.

Opmerking: De device_info vervangt deze parameter. Indien gebruikt, appId moeten dezelfde waarden hebben als in de Registratiecode maken verzoek.
NOTE
De informatie van gebruikersmeta-gegevens zou beschikbaar moeten zijn nadat de authentificatiestroom heeft voltooid, maar kan op de vergunningsstroom, afhankelijk van MVPD en op het meta-gegevenstype worden bijgewerkt.

Samplereactie sample-response

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: geeft een UNIX-tijdstempel op die de laatste keer vertegenwoordigt dat de metagegevens zijn 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.
  • data: bevat de werkelijke metagegevenswaarden.
  • gecodeerd: een array met de gecodeerde eigenschappen. 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.

Zie voor meer informatie Metagegevens gebruiker.

Terug naar REST API Reference

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