DocumentatieAdobe PassAdobe Pass-verificatie

Toegangstoken ophalen retrieve-access-token

Last update: Mon Aug 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
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
De dynamische implementatie van de Registratie API van de Cliënt wordt begrensd door de Throttling mechanismedocumentatie.

Verzoek request

HTTP
pad
/o/client/token
methode
POST
Bodyparameters
client_id
De id-tekenreeks van de clienttoepassing.

Voor meer informatie over hoe te om het koord van het cliëntherkenningsteken te verkrijgen, verwijs naar de 2} API documentatie van de cliëntgeloofsbrieven {terugwinnen.
vereist
client_geheime
De geheime tekenreeks van de clienttoepassing.

Voor meer informatie over hoe te om het cliënt geheime koord te verkrijgen, verwijs naar terugwinnen cliëntgeloofsbrievenAPI documentatie.
vereist
subsidie_type
De tekenreeks met het giftetype (bijvoorbeeld "client_credentials") die de clienttoepassing kan gebruiken voor het client-tokeneindpunt.

Voor meer informatie over hoe te om het subsidietype koord te verkrijgen, verwijs naar de 2} API documentatie van de cliëntgeloofsbrieven {terugwinnen.
vereist
Kopteksten
Inhoudstype
Het geaccepteerde mediatype voor de bronnen die worden verzonden.

Het moet application/x-www-form-urlencoded zijn.
vereist
X-Apparaat-Info
De generatie van de lading van de apparateninformatie wordt beschreven in x-apparaat-Infodocumentatie.

Het wordt ten zeerste aanbevolen deze altijd te gebruiken wanneer het apparaatplatform van de toepassing expliciet geldige waarden biedt.

Als deze optie is opgegeven, worden waarden met geëxtraheerde waarden expliciet samengevoegd met de Adobe Pass-verificatieachterkant (standaard).

Als deze optie niet is opgegeven, gebruikt de Adobe Pass Authentication-backend impliciet geëxtraheerde waarden (standaard).
vereist
Accepteren
Het mediatype dat door de clienttoepassing wordt geaccepteerd.

Indien gespecificeerd, moet het application/json zijn.
optioneel
Gebruikersagent
De gebruikersagent van de clienttoepassing.
optioneel

Antwoord response

Succes success

Kopteksten
Status
201
vereist
Inhoudstype
application/json
vereist
Lichaam

JSON-object met de volgende kenmerken:

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
Kenmerk
id De dekkende id die kan worden gebruikt voor het bijhouden van de gebruikersactiviteit. vereist
access_token De waarde van het toegangstoken de cliënttoepassing voor de kopbal van de Vergunning moet gebruiken. vereist
created_at De tijd waarop het toegangstoken werd uitgegeven. vereist
verloopt_in De tijd in seconden tot het toegangstoken verloopt. vereist
token_type Het tokentype (bijvoorbeeld "toonder"). vereist
vereist

Fout error

Kopteksten
Status
400
vereist
Inhoudstype
application/json
vereist
Lichaam
fout

De mogelijke waarden zijn:

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
Waarde
invalid_request

Het verzoek is om een van de volgende redenen ongeldig:

  • In het verzoek ontbreekt een vereiste parameter.
  • Het verzoek bevat een niet-ondersteunde parameterwaarde (anders dan een type subsidie).
  • De aanvraag herhaalt een parameter.
  • Het verzoek bevat meerdere referenties.
  • Het verzoek gebruikt meer dan één mechanisme om de cliënt voor authentiek te verklaren.
  • Het verzoek is onjuist geformuleerd.
invalid_client De clientreferenties zijn ongeldig, de client moet nieuwe clientgegevens verkrijgen en het opnieuw proberen. Voor meer details verwijs naar terugwinnen cliëntgeloofsbrievenAPI documentatie.
onbevoegd_client Het gebruikte subsidietype is ongeldig.
vereist

Voorbeelden samples

Toegangstoken ophalen samples-retrieve-access-token

Verzoek
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
Reactie - Succes
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": 1723227212,
  "expires_in": 86400,
  "token_type": "bearer"
}
Reactie - Fout
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