DocumentaçãoAdobe PassAdobe Pass Authentication

Recuperar credenciais do cliente retrieve-client-credentials

Last update: Tue Sep 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
O conteúdo desta página é fornecido apenas para fins informativos. O uso desta API requer uma licença atual do Adobe. Não é permitida nenhuma utilização não autorizada.
IMPORTANT
A implementação da API de Registro de Cliente Dinâmico é limitada pela documentação do Mecanismo de limitação.

Solicitação request

HTTP
caminho
/o/client/register
método
POST
Parâmetros de corpo
declaração_do_software
A instrução de software associada ao aplicativo registrado criado e baixado do Painel do Adobe Pass TVE.

O gerenciamento de aplicativos registrados está descrito na documentação da Visão geral do registro dinâmico do cliente.
obrigatório
redirect_uri
O URI de redirecionamento associado ao local para o qual o agente do usuário navega quando o fluxo de autenticação é concluído.
opcional
Cabeçalhos
Tipo de conteúdo
O tipo de mídia aceito para os recursos que estão sendo enviados.

Deve ser application/json.
obrigatório
X-Device-Info
A geração da carga de informações do dispositivo está descrita na documentação X-Device-Info.

É altamente recomendável sempre usá-lo quando a plataforma do dispositivo do aplicativo permitir a provisão explícita de valores válidos.

Quando fornecido, o back-end da Autenticação do Adobe Pass mesclará explicitamente valores definidos com valores extraídos implicitamente (por padrão).

Quando não for fornecido, o back-end da Autenticação do Adobe Pass usará os valores extraídos implicitamente (por padrão).
obrigatório
Aceitar
O tipo de mídia aceito pelo aplicativo cliente.

Se especificado, deve ser application/json.
opcional
User-Agent
O agente do usuário do aplicativo cliente.
opcional

Resposta response

Sucesso success

Cabeçalhos
Status
201
obrigatório
Tipo de conteúdo
application/json
obrigatório
Corpo

Objeto JSON com os seguintes atributos:

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
Atributo
client_id A string do identificador do aplicativo cliente. obrigatório
client_secret A string secreta do aplicativo do cliente. obrigatório
client_id_issue_at A hora em que o identificador de aplicativo cliente foi emitido. obrigatório
redirect_uris A matriz de cadeias de caracteres de URI de redirecionamento que o aplicativo cliente pode usar em fluxos baseados em redirecionamento. obrigatório
grant_types As cadeias de caracteres do tipo concessão que o aplicativo cliente pode usar para o ponto de extremidade do token do cliente. obrigatório
escopos As cadeias de caracteres de escopo que definem as APIs de Autenticação do Adobe Pass que o aplicativo cliente pode usar. obrigatório
obrigatório

Erro error

Cabeçalhos
Status
400
obrigatório
Tipo de conteúdo
application/json
obrigatório
Corpo
erro

Os valores possíveis são:

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

A solicitação é inválida devido a um dos seguintes motivos:

  • A solicitação perde um parâmetro obrigatório.
  • A solicitação inclui um valor de parâmetro sem suporte.
  • A solicitação repete um parâmetro.
  • A solicitação está malformada.
invalid_redirect_uri A solicitação inclui um valor inválido para o URI de redirecionamento.
instrução_de_software_inválida A solicitação inclui um valor inválido para a instrução de software.
unapproved_software_statement A solicitação inclui um valor para a instrução de software que não foi aprovado para uso pelo servidor de Autenticação do Adobe Pass.
obrigatório

Amostras samples

Recuperar credenciais do cliente samples-retrieve-client-credentials

Solicitação
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"
 }
Resposta - Êxito
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
}
Resposta - Erro
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