DocumentaçãoAdobe PassAdobe Pass Authentication

Recuperar token de autorização retrieve-authorization-token

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
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.
NOTE
A implementação da REST API é limitada por Mecanismo de limitação

Endpoints da REST API clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

Descrição description

Recupera o token de autorização (AuthZ).

Endpoint
Chamado
por
Entrada
Parâmetros
HTTP
Método
Resposta
Resposta HTTP
<SP_FQDN>/api/v1/tokens/authz

Por exemplo:

<SP_FQDN>/api/v1/tokens/authz
Aplicativo de Streaming

ou

Serviço de Programador
1. solicitante (obrigatório)
2. deviceId (Obrigatório)
3. recurso (obrigatório)
4. device_info/X-Device-Info (Obrigatório)
5. deviceType
6. deviceUser (Obsoleto)
7. appId (obsoleto)
GET
1. Êxito
2. Token de autenticação
não encontrado ou expirado:
Motivo explicativo XML
token de autenticação não encontrado
3. Token de autorização
não encontrado:
Explicação XML
4. Token de autorização
expirado:
Explicação de XML
200 - Êxito
412 - Sem AuthN

404 - Sem AuthZ

410 - AuthZ Expirado
Parâmetro de entrada
Descrição
solicitante
O requestorId do Programador para o qual esta operação é válida.
deviceId
Os bytes de id do dispositivo.
recurso
Uma cadeia de caracteres que contém um resourceId (ou fragmento MRSS), identifica o conteúdo solicitado por um usuário e é reconhecida por pontos de extremidade de autorização MVPD.
device_info/

X-Device-Info
Informações do dispositivo de transmissão.

Observação: isso PODE ser passado para device_info como um parâmetro de URL, mas devido ao tamanho potencial desse parâmetro e às limitações no comprimento de uma URL GET, DEVE ser passado como X-Device-Info no cabeçalho http.

Veja os detalhes completos em Passando Informações sobre Dispositivo e Conexão.
deviceType
O tipo de dispositivo (por exemplo, Roku, PC).

Se este parâmetro estiver definido corretamente, o ESM oferecerá métricas que são analisadas por tipo de dispositivo ao usar o sem cliente, para que diferentes tipos de análise possam ser executados, por exemplo, Roku, Apple TV e Xbox.

Consulte, Vantagens de usar o parâmetro de tipo de dispositivo sem cliente em métricas de passagem

Observação: device_info substituirá esse parâmetro.
deviceUser
O identificador do usuário do dispositivo.
appId
O id/nome do aplicativo.

Observação: device_info substitui este parâmetro.

Exemplo de resposta response

Sucesso

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authorization>
        <expires>1348148289000</expires>
        <mvpd>sampleMvpdId</mvpd>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <proxyMvpd>sampleProxyMvpdId</proxyMvpd>
    </authorization>

JSON:

    {
        "mvpd": "sampleMvpdId",
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348148289000",
        "proxyMvpd": "sampleProxyMvpdId"
    }

Token de autenticação não encontrado ou expirado:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>412</status>
        <message>User not authenticated</message>
    </error>

JSON:

    {
        "status": 412,
        "message": "User not authenticated",
        "details": null
    }

Token de autorização não encontrado:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>404</status>
        <message>Not found</message>
    </error>

JSON:

    {
        "status": 404,
        "message": "Not Found",
        "details": null
    }

Token de autorização expirado:

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>410</status>
        <message>Gone</message>
    </error>

JSON:

    {
        "status": 410,
        "message": "Gone",
        "details": null
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b