Hämta åtkomsttoken retrieve-access-token

IMPORTANT
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.
IMPORTANT
Implementeringen av API:t för registrering av dynamiska klienter begränsas av dokumentationen för begränsningsmekanismen.

Begäran request

HTTP
bana
/o/client/token
method
POST
Kroppsparametrar
client_id
Klientprogrammets identifierarsträng.

Mer information om hur du hämtar klientidentifierarsträngen finns i API-dokumentationen för Hämta klientautentiseringsuppgifter.
obligatoriskt
client_secrets
Klientprogrammets hemliga sträng.

Mer information om hur du hämtar klienthemlighetssträngen finns i API-dokumentationen för Hämta klientinloggningsuppgifter.
obligatoriskt
grant_type
Den tilldelningstypssträng (t.ex. "client_credentials") som klientprogrammet kan använda för klientens token-slutpunkt.

Mer information om hur du hämtar tilldelningstypssträngen finns i API-dokumentationen för Hämta klientinloggningsuppgifter.
obligatoriskt
Sidhuvuden
Content-Type
Godkänd medietyp för resurserna som skickas.

Det måste vara application/x-www-form-urlencoded.
obligatoriskt
X-Device-Info
Genereringen av nyttolasten för enhetsinformation beskrivs i X-Device-Info -dokumentationen.

Vi rekommenderar att du alltid använder den när programmets enhetsplattform tillåter explicit tillhandahållande av giltiga värden.

När detta anges sammanfogas Adobe Pass Authentication-backend explicit med extraherade värden implicit (som standard).

Om det inte anges kommer Adobe Pass Authentication-serverdelen att använda extraherade värden implicit (som standard).
obligatoriskt
Acceptera
Medietypen som accepteras av klientprogrammet.

Om det anges måste det vara application/json.
valfri
Användaragent
Användaragenten för klientprogrammet.
valfri

Svar response

Lyckades success

Sidhuvuden
Status
201
obligatoriskt
Content-Type
application/json
obligatoriskt
Brödtext

JSON-objekt med följande attribut:

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
Attribut
id Den ogenomskinliga identifierare som kan användas för att spåra användaraktivitet. obligatoriskt
access_token Det åtkomsttokenvärde som klientprogrammet måste använda för auktoriseringshuvudet. obligatoriskt
created_at Tiden i millisekunder som åtkomsttoken utfärdades. obligatoriskt
förfaller_in Tiden i sekunder tills åtkomsttoken upphör att gälla. obligatoriskt
token_type Tokentyp (t.ex. "innehavare"). obligatoriskt
obligatoriskt

Fel error

Sidhuvuden
Status
400
obligatoriskt
Content-Type
application/json
obligatoriskt
Brödtext
fel

Möjliga värden är:

table 0-row-3 1-row-2 2-row-2 3-row-2 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 8-bgcolor-deebff 11-bgcolor-deebff layout-auto html-authored
Värde
invalid_request

Begäran är ogiltig på grund av en av följande orsaker:

  • Begäran saknar en obligatorisk parameter.
  • Begäran innehåller ett parametervärde som inte stöds (annat än anslagstyp).
  • Begäran upprepar en parameter.
  • Begäran innehåller flera autentiseringsuppgifter.
  • Begäran använder mer än en mekanism för att autentisera klienten.
  • Begäran har fel format.
invalid_client Klientens autentiseringsuppgifter är ogiltiga. Klienten måste hämta nya klientautentiseringsuppgifter och försöka igen. Mer information finns i API-dokumentationen för Hämta klientautentiseringsuppgifter.
unauthorized_client Den anslagstyp som används är ogiltig.
obligatoriskt

Exempel samples

Hämta åtkomsttoken samples-retrieve-access-token

Begäran
code language-https
POST /o/client/token HTTP/1.1

    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Content-Type: application/x-www-form-urlencoded
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

Body:

client_id=s6BhdRkqt3&client_secret=t7AkePiru4&grant_type=client_credentials
Svar - lyckat
code language-https
HTTP/1.1 201 Created

Content-Type: application/json;charset=UTF-8

{
  "id": "a932f8f0-210a-41a4-b2a8-377751f6b76f",
  "access_token": "2YotnFZFEjr1zCsicMWpAA",
  "created_at": 1752148106221,
  "expires_in": 21600,
  "token_type": "bearer"
}
Svar - Fel
code language-https
HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

{ "error": "invalid_request" }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b