Hämta klientautentiseringsuppgifter retrieve-client-credentials

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/register
method
POST
Kroppsparametrar
software_statement
Programsatsen som är associerad med det registrerade programmet som har skapats och hämtats från Adobe Pass TVE Dashboard.

Hanteringen av registrerade program beskrivs i Översikt över registrering av dynamiska klienter.
obligatoriskt
redirect_uri
Omdirigerings-URI som är associerad med den plats som användaragenten navigerar till när autentiseringsflödet är slutfört.
valfri
Sidhuvuden
Content-Type
Godkänd medietyp för resurserna som skickas.

Det måste vara application/json.
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 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
Attribut
client_id Klientprogrammets identifierarsträng. obligatoriskt
client_secrets Klientprogrammets hemliga sträng. obligatoriskt
client_id_Issu_at_at Den tidpunkt då klientprogrammets identifierare utfärdades. obligatoriskt
redirect_uris Arrayen med URI-strängar för omdirigering som klientprogrammet kan använda i omdirigeringsbaserade flöden. obligatoriskt
grant_types De tilldelningstypssträngar som klientprogrammet kan använda för klienttokens slutpunkt. obligatoriskt
omfattningar Omfattningssträngarna som definierar de Adobe Pass-autentiserings-API:er som klientprogrammet kan använda. 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 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
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.
  • Begäran upprepar en parameter.
  • Begäran har fel format.
invalid_redirect_uri Begäran innehåller ett ogiltigt värde för omdirigerings-URI.
invalid_software_statement Begäran innehåller ett ogiltigt värde för programsatsen.
unapproved_software_statement Begäran innehåller ett värde för programsatsen som inte är godkänd för användning av Adobe Pass autentiseringsserver.
obligatoriskt

Exempel samples

Hämta klientautentiseringsuppgifter samples-retrieve-client-credentials

Begäran
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"
 }
Svar - lyckat
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
}
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