Hämta auktoriseringstoken retrieve-authorization-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>:
- Produktion - api.auth.adobe.com
- Mellanlagring - api.auth-staging.adobe.com
<SP_FQDN>:
- Produktion - api.auth.adobe.com
- Mellanlagring - api.auth-staging.adobe.com
Beskrivning description
Hämtar AuthZ-token.
Slutpunkt
Anropat
av
av
Indata
Parametrar
Parametrar
HTTP
Metod
Metod
Svar
HTTP
Response
Response
<SP_FQDN>/api/v1/tokens/authz
Till exempel:
<SP_FQDN>/api/v1/tokens/authz
Till exempel:
<SP_FQDN>/api/v1/tokens/authz
Direktuppspelande app
eller
Programmeringtjänst
eller
Programmeringtjänst
1. beställare (obligatoriskt)
2. deviceId (obligatoriskt)
3. resurs (obligatoriskt)
4. device_info/X-Device-Info (obligatoriskt)
5. deviceType
6. deviceUser (utgått)
7. appId (inaktuellt)
2. deviceId (obligatoriskt)
3. resurs (obligatoriskt)
4. device_info/X-Device-Info (obligatoriskt)
5. deviceType
6. deviceUser (utgått)
7. appId (inaktuellt)
GET
1. Lyckades
2. Autentiseringstoken
hittades inte eller har gått ut:
Förklaring av XML
för författartoken hittades inte
. Auktoriseringstoken
hittades inte:
XML-förklaring
4. Auktoriseringstoken
utgången:
XML-förklaring
2. Autentiseringstoken
hittades inte eller har gått ut:
Förklaring av XML
för författartoken hittades inte
. Auktoriseringstoken
hittades inte:
XML-förklaring
4. Auktoriseringstoken
utgången:
XML-förklaring
200 - Lyckades
412 - Inget AuthN
404 - Ingen AuthZ
410 - AuthZ har gått ut
412 - Inget AuthN
404 - Ingen AuthZ
410 - AuthZ har gått ut
Indataparameter
Beskrivning
begärande
Programmerarens requestId som den här åtgärden är giltig för.
deviceId
Byte för enhets-ID.
resurs
En sträng som innehåller ett resourceId (eller MRSS-fragment), identifierar innehållet som begärts av en användare och känns igen av MVPD-auktoriseringsslutpunkter.
device_info/
X-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.
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).
Om den här parametern är korrekt har ESM värden som är nedbrutna per enhetstyp när klientlösa används, så att olika typer av analyser kan utföras, till exempel Roku, AppleTV och Xbox.
Se, Fördelar med att använda parametern för klientlös enhetstyp i pass-mått
Obs! Parametern device_info kommer att ersättas.
Om den här parametern är korrekt har ESM värden som är nedbrutna per enhetstyp när klientlösa används, så att olika typer av analyser kan utföras, till exempel Roku, AppleTV och Xbox.
Se, Fördelar med att använda parametern för klientlös enhetstyp i pass-mått
Obs! Parametern device_info kommer att ersättas.
deviceUser
Enhetens användaridentifierare.
appId
Program-ID/namn.
Obs!: device_info ersätter den här parametern.
Obs!: device_info ersätter den här parametern.
Exempelsvar response
Lyckades
XML:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<authorization>
<expires>1348148289000</expires>
<mvpd>sampleMvpdId</mvpd>
<requestor>sampleRequestorId</requestor>
<resource>sampleResourceId</resource>
<proxyMvpd>sampleProxyMvpdId</proxyMvpd>
</authorization>
JSON:
{
"mvpd": "sampleMvpdId",
"resource": "sampleResourceId",
"requestor": "sampleRequestorId",
"expires": "1348148289000",
"proxyMvpd": "sampleProxyMvpdId"
}
Autentiseringstoken saknas eller har upphört att gälla:
XML:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<error>
<status>412</status>
<message>User not authenticated</message>
</error>
JSON:
{
"status": 412,
"message": "User not authenticated",
"details": null
}
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",
"details": null
}
Auktoriseringstoken har upphört att gälla:
XML:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<error>
<status>410</status>
<message>Gone</message>
</error>
JSON:
{
"status": 410,
"message": "Gone",
"details": null
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b