Client-referenties ophalen retrieve-client-credentials

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/register
methode
POST
Bodyparameters
software_statement
De softwareverklaring verbonden aan de geregistreerde toepassing die van wordt gecreeerd en van Dashboard van Adobe Pass TVEwordt gedownload.

Het beheer van geregistreerde toepassingen wordt beschreven in de Dynamische documentatie van de Registratie van de Cliënt van het Overzicht.
vereist
redirect_uri
De omleiding URI verbonden aan de plaats waaraan de gebruikersagent navigeert wanneer de authentificatiestroom wordt voltooid.
optioneel
Kopteksten
Inhoudstype
Het geaccepteerde mediatype voor de bronnen die worden verzonden.

Het moet application/json 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 6-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 25-bgcolor-deebff layout-auto html-authored
Kenmerk
client_id De id-tekenreeks van de clienttoepassing. vereist
client_geheime De geheime tekenreeks van de clienttoepassing. vereist
client_id_issued_at Het tijdstip waarop de id van de clienttoepassing is uitgegeven. vereist
redirect_uris De array van URI-tekenreeksen voor omleiding die de clienttoepassing kan gebruiken in op omleiding gebaseerde stromen. vereist
Grant_types Het subsidietype koorden die de cliënttoepassing voor het cliënt symbolische eindpunt kan gebruiken. vereist
bereik De bereiktekenreeksen die de Adobe Pass-verificatie-API's definiëren die de clienttoepassing kan gebruiken. 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 4-row-2 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 8-bgcolor-deebff 11-bgcolor-deebff 14-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.
  • De aanvraag bevat een niet-ondersteunde parameterwaarde.
  • De aanvraag herhaalt een parameter.
  • Het verzoek is onjuist geformuleerd.
invalid_redirect_uri De aanvraag bevat een ongeldige waarde voor de omleiding-URI.
invalid_software_statement De aanvraag bevat een ongeldige waarde voor de softwareinstructie.
unsigned_software_statement De aanvraag bevat een waarde voor de softwareinstructie die niet is goedgekeurd voor gebruik door de Adobe Pass Authentication-server.
vereist

Voorbeelden samples

Client-referenties ophalen samples-retrieve-client-credentials

Verzoek
code language-https
POST /o/client/register HTTP/1.1

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

{
    "software_statement": "eyJhbGciOiJSUzI1NiJ9.
        eyJzb2Z0d2FyZV9pZCI6IjROUkIxLTBYWkFCWkk5RTYtNVNNM1IiLCJjbGll
        bnRfbmFtZSI6IkV4YW1wbGUgU3RhdGVtZW50LWJhc2VkIENsaWVudCIsImNs
        aWVudF91cmkiOiJodHRwczovL2NsaWVudC5leGFtcGxlLm5ldC8ifQ.
        GHfL4QNIrQwL18BSRdE595T9jbzqa06R9BT8w409x9oIcKaZo_mt15riEXHa
        zdISUvDIZhtiyNrSHQ8K4TvqWxH6uJgcmoodZdPwmWRIEYbQDLqPNxREtYn0
        5X3AR7ia4FRjQ2ojZjk5fJqJdQ-JcfxyhK-P8BAWBd6I2LLA77IG32xtbhxY
        fHX7VhuU5ProJO8uvu3Ayv4XRhLZJY4yKfmyjiiKiPNe-Ia4SMy_d_QSWxsk
        U5XIQl5Sa2YRPMbDRXttm2TfnZM1xx70DoYi8g6czz-CPGRi4SW_S2RKHIJf
        IjoI3zTJ0Y2oe0_EJAiXbL6OyF9S5tKxDXV8JIndSA",
    "redirect_uri": "adobepass://com.programmer"
 }
Reactie - Succes
code language-https
HTTP/1.1 201 Created

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

{
    "client_id": "s6BhdRkqt3",
    "client_secret": "t7AkePiru4",
    "redirect_uris": [
        "app://com.programmer.adobe#sdasdsadas"
    ],
    "grant_types": [
        "client_credentials"
    ],
    "scopes": [
        "api:client:v2"
    ],
    "client_id_issued_at": 1723227212
}
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