Partilhar via

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 para a Nuvem Microsoft para o Governo dos EUA

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.

Cabeçalho Descrição Tipo de valor
Authorization: É necessário. O token de autorização no formato "Bearer <token>". string
Accept: 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 (Identificador Globalmente Único)
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 Test and debug. GUID
MS-Contract-Version: Necessário. Especifica a versão da API solicitada; Este valor geralmente é api-version: v1, a menos que especificado de outra forma na seção Cenários de . string
If-Match: 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 obter a versão mais recente. Para obter mais informações, consulte as informações do ETag em Test and debug. string
MS-PartnerCenter-Application Opcional. Especifica o nome do aplicativo que está usando a API REST do Partner Center. string
X-Locale: 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 Descrição Tipo de valor
Accept: Especifica o tipo de solicitação e resposta, application/json. sequência de caracteres
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. Identificador Global Único (GUID)