Hämta autentiseringstoken retrieve-authentication-token

NOTE
Innehållet på den här sidan tillhandahålls endast i informationssyfte. Användning av denna API kräver en aktuell licens från Adobe. Ingen obehörig användning är tillåten.
NOTE
REST API-implementeringen begränsas av Begränsningsmekanismen

REST API-slutpunkter clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

Beskrivning description

Hämtar autentiseringstoken (AuthN).

Slutpunkt
Anropat
av
Indata
Parametrar
HTTP
Metod
Svar
HTTP
Response
<SP_FQDN>/api/v1/tokens/authn

Till exempel:

<SP_FQDN>/api/v1/tokens/authn
Direktuppspelande app

eller

Programmeringtjänst
1. beställare (obligatoriskt)
2. deviceId (obligatoriskt)
3. device_info/X-Device-Info (obligatoriskt)
4. deviceType (utgått)
5. deviceUser (utgått)
6. appId (inaktuellt)
GET
XML eller JSON som innehåller autentiseringsinformation eller felinformation om det misslyckas.
200 - Klart.
404 - Det gick inte att hitta token
410 - token har upphört att gälla
Indataparameter
Beskrivning
begärande
Programmerarens requestId som den här åtgärden är giltig för.
deviceId
Byte för enhets-ID.
device_info/

X-Device-Info
Information om direktuppspelningsenhet.

Obs!: Detta kan skickas som device_info som URL-parameter, men på grund av parameterns potentiella storlek och begränsningar i längden på en GET-URL, bör det skickas som X-Device-Info i http-huvudet.

Mer information finns i Skicka information om enheter och anslutningar.
deviceType
Enhetstypen (till exempel Roku, PC).

Obs!: device_info ersätter den här parametern.
deviceUser
Enhetens användaridentifierare.

Obs! Om det används ska deviceUser ha samma värden som i begäran Skapa registreringskod.
appId
Program-ID/namn.

Obs!: device_info ersätter den här parametern. Om det används ska appId ha samma värden som i begäran Skapa registreringskod.

Exempelsvar response

Lyckades

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authentication>
         <expires>1601114932000</expires>
         <userId>sampleUserId</userId>
         <mvpd>sampleMvpdId</mvpd>
         <requestor>sampleRequestor</requestor>
    </authentication>

JSON:

    {
         "requestor": "sampleRequestor",
         "mvpd": "sampleMvpdId",
         "userId": "sampleUserId",
         "expires": "1601114932000"
    }

Autentiseringstoken hittades inte:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>404</status>
        <message>Not found</message>
    </error>

JSON:

    {
        "status": 404,
        "message": "Not Found"
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b