Partilhar via


Authentication - Generate access token

Gera um token de acesso necessário para aceder a poucos recursos api parceiros.

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

Cabeçalho do Pedido

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

Name Necessário Tipo Description
Authorization True

string

Ficha do Portador de Autorização

Accept True

string

Tipo de conteúdo aceitável; aplicação/json tipo amplamente accepeted

ms-correlationid

string

Usado para rastrear pedidos internamente. Se um ms-correlaid não for fornecido, o servidor gerará um novo para cada pedido

ms-requestid

string

Usado para idempoteência de pedidos. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada pedido

Corpo do Pedido

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

Name Tipo Description
grant_type

string

Só suporta grant_type=jwt_token

Respostas

Name Tipo Description
200 OK

O pedido foi bem sucedido.

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

400 Bad Request

Havia uma entrada desaparecida ou inválida. O corpo de resposta contém os detalhes de erro.

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

401 Unauthorized

O pedido não foi autenticado. O cliente precisa de autenticar primeiro com o serviço API do parceiro.

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

403 Forbidden

O pedido foi autenticado, mas foi recusado porque o chamador não tem o direito de o invocar.

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

404 Not Found

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

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

500 Internal Server Error

O serviço API do parceiro ou uma das suas dependências não cumpriu o pedido. Os chamadores podem voltar a tentar o pedido.

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