REST do Partner Center e cabeçalhos de resposta suportados pela API REST do Partner Center

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government

A API REST do Partner Center suporta os seguintes cabeçalhos de solicitação e resposta HTTP. Nem todas as chamadas de API aceitam todos os cabeçalhos.

Cabeçalhos de solicitação REST

A API REST do Partner Center suporta os seguintes cabeçalhos de solicitação HTTP suportados pela API REST do Partner Center.

Cabeçalho Description Tipo de valor
Autorização: Obrigatório. O token de autorização no formato Token> de portador<. string
Aceitar: Especifica o tipo de solicitação e resposta, application/json. string
MS-RequestId: Um identificador exclusivo para a chamada, usado para garantir id-potency. Se houver um tempo limite, a chamada de repetição deve incluir o mesmo valor. Ao receber uma resposta (sucesso ou fracasso comercial), o valor deve ser redefinido para a próxima chamada. GUID
MS-CorrelationId: Um identificador exclusivo para a chamada, útil em logs e rastreamentos de rede para solucionar erros. O valor deve ser redefinido para cada chamada. Todas as operações devem incluir este cabeçalho. Para obter mais informações, consulte as informações de ID de correlação em Testar e depurar. GUID
MS-Contract-Version: Obrigatório. Especifica a versão da API solicitada; Esse valor geralmente é api-version: v1, a menos que especificado de outra forma na seção Cenários . string
Se-Correspondência: Usado para controle de simultaneidade. Algumas chamadas de API exigem a passagem do ETag através do cabeçalho If-Match. O ETag geralmente está no recurso e, portanto, requer GET-ting o mais recente. Para obter mais informações, consulte as informações do ETag em Testar e depurar. string
Aplicação MS-PartnerCenter Opcional. Especifica o nome do aplicativo que está usando a API REST do Partner Center. string
X-Localidade: Opcional. Especifica o idioma no qual as taxas são retornadas. O padrão é en-US. Para obter uma lista de valores suportados, consulte Idiomas e localidades suportados pelo Partner Center. string

Cabeçalhos de resposta REST

A API REST do Partner Center pode retornar os seguintes cabeçalhos de resposta HTTP:

Cabeçalho Description Tipo de valor
Aceitar: Especifica o tipo de solicitação e resposta, application/json. string
MS-RequestId: Um identificador exclusivo para a chamada, usado para garantir id-potency. Se houver um tempo limite, a chamada de repetição deve incluir o mesmo valor. Ao receber uma resposta (sucesso ou fracasso comercial), o valor deve ser redefinido para a próxima chamada. GUID
MS-CorrelationId: Um identificador exclusivo para a chamada. Esse valor é útil para solucionar problemas de logs e rastreamentos de rede para localizar o erro. O valor deve ser redefinido para cada chamada. Todas as operações devem incluir este cabeçalho. GUID