Compartilhar via


Authentication - Generate access token

Gera um token de acesso necessário para acessar alguns recursos de API de parceiro. Esta é a versão atual da API, descontinue o uso da versão mais antiga que está sendo preterida Gerar Token de Acesso (Preterindo)

POST https://api.partnercenter.microsoft.com/v3/generatetoken

Cabeçalho da solicitação

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"

Nome Obrigatório Tipo Description
Authorization True

string

Token de portador de autorização. Usa apenas o token com api.partnercenter.microsoft.com de audiência para o cenário somente de aplicativo. Consulte substituição do token de grafo do Active Directory para obter informações detalhadas.

Accept True

string

Tipo de conteúdo aceitável; aplicativo/json de tipo amplamente accepeted

ms-correlationid

string

Usado para acompanhar solicitações internamente. Se um ms-correlationid não for fornecido, o servidor gerará um novo para cada solicitação

ms-requestid

string

Usado para idempotency de solicitações. Se uma ms-requestid não for fornecida, o servidor gerará uma nova para cada solicitação

Corpo da solicitação

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"

Nome Tipo Description
grant_type

string

Só dá suporte a grant_type=jwt_token

Respostas

Nome Tipo Description
200 OK

A solicitação foi bem-sucedida.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

400 Bad Request

Havia uma entrada ausente ou inválida. O corpo da resposta contém os detalhes do erro.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

401 Unauthorized

A solicitação não foi autenticada. Primeiro, o cliente precisa se autenticar com o serviço de API do parceiro.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

403 Forbidden

A solicitação foi autenticada, mas foi recusada porque o chamador não tem os direitos de invocá-la.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

404 Not Found

O recurso não foi encontrado ou não está disponível com os parâmetros de entrada especificados.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

500 Internal Server Error

O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem repetir a solicitação.

Media Types: "application/json", "application/xml", "text/xml", "text/json"