DocumentaçãoAdobe PassAdobe Pass Authentication

Recuperar token de acesso retrieve-access-token

Last update: Fri Dec 06 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/token
método
POST
Parâmetros de corpo
client_id
A string do identificador do aplicativo cliente.

Para obter mais informações sobre como obter a cadeia de caracteres do identificador do cliente, consulte a documentação da API Recuperar credenciais do cliente.
obrigatório
client_secret
A string secreta do aplicativo do cliente.

Para obter mais informações sobre como obter a cadeia de caracteres secreta do cliente, consulte a documentação da API Recuperar credenciais do cliente.
obrigatório
grant_type
A string do tipo concessão (por exemplo, "client_credentials") que o aplicativo cliente pode usar para o endpoint do token do cliente.

Para obter mais informações sobre como obter a cadeia de caracteres de tipo de concessão, consulte a documentação da API Recuperar credenciais do cliente.
obrigatório
Cabeçalhos
Tipo de conteúdo
O tipo de mídia aceito para os recursos que estão sendo enviados.

Deve ser application/x-www-form-urlencoded.
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 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
Atributo
id O identificador opaco que pode ser usado para rastrear a atividade do usuário. obrigatório
access_token O valor do token de acesso que o aplicativo cliente deve usar para o cabeçalho de Autorização. obrigatório
created_at A hora em que o token de acesso foi emitido. obrigatório
expires_in O tempo em segundos até o token de acesso expirar. obrigatório
token_type O tipo de token (por exemplo, "portador"). 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 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 8-bgcolor-deebff 11-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 (diferente do tipo de concessão).
  • A solicitação repete um parâmetro.
  • A solicitação inclui várias credenciais.
  • A solicitação usa mais de um mecanismo para autenticar o cliente.
  • A solicitação está malformada.
invalid_client As credenciais do cliente são inválidas, o cliente precisa obter novas credenciais e tentar novamente. Para obter mais detalhes, consulte a documentação da API Recuperar credenciais do cliente.
unauthorized_client O tipo de concessão usado é inválido.
obrigatório

Amostras samples

Recuperar token de acesso samples-retrieve-access-token

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