A API REST do Partner Center dá suporte para cabeçalhos REST e de resposta do Partner Center
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para a Nuvem da Microsoft para o Governo dos EUA
A API REST do Partner Center dá suporte aos seguintes cabeçalhos de solicitação e resposta HTTP. Nem todas as chamadas à API aceitam todos os cabeçalhos.
Cabeçalhos de solicitação REST
A API REST do Partner Center dá suporte aos seguintes cabeçalhos de solicitação HTTP.
Cabeçalho | Descrição | Tipo de valor |
---|---|---|
Authorization: |
Obrigatório. O token de autorização na forma <token de portador>. | cadeia de caracteres |
Accept: |
Especifica o tipo de solicitação e resposta, aplicativo/json. | cadeia de caracteres |
MS-RequestId: |
Um identificador exclusivo para a chamada, usado para garantir a id-potência. Se houver um tempo limite, a chamada de repetição deverá incluir o mesmo valor. Após receber uma resposta (êxito ou falha nos negócios), 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 problemas de erros. O valor deve ser redefinido para cada chamada. Todas as operações devem incluir esse 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 . | cadeia de caracteres |
If-Match: |
Usado para controle de simultaneidade. Algumas chamadas à API exigem passar a ETag por meio do cabeçalho If-Match. A Etag geralmente está no recurso e, portanto, requer a obtenção da versão mais recente usando GET. Para obter mais informações, consulte as informações de Etag em Testar e depurar. | cadeia de caracteres |
MS-PartnerCenter-Application |
Opcional. Especifica o nome do aplicativo que está usando a API REST do Partner Center. | cadeia de caracteres |
X-Locale: |
Opcional. Especifica o idioma no qual as taxas são retornadas. O padrão é en-US. Para obter uma lista de valores com suporte, consulte Idiomas e localidades com suporte no Partner Center. | cadeia de caracteres |
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, aplicativo/json. | cadeia de caracteres |
MS-RequestId: |
Um identificador exclusivo para a chamada, usado para garantir a id-potência. Se houver um tempo limite, a chamada de repetição deverá incluir o mesmo valor. Após receber uma resposta (êxito ou falha nos negócios), 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 esse cabeçalho. | Identificador Globalmente Único (GUID) |