REST do Partner Center e cabeçalhos de resposta suportados pela API REST do Partner Center
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government
A API REST do Partner Center oferece 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 oferece suporte aos seguintes cabeçalhos de solicitação HTTP são suportados pela API REST do Partner Center.
| parâmetro | Descrição | Tipo de valor |
|---|---|---|
| Autorização: | Obrigatório. O token de autorização no formulário do <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 a id-potency. Se houver um tempo limite, a chamada de repetição deverá incluir o mesmo valor. Após receber uma resposta (êxito ou falha empresarial), 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 solução de 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 |
| If-Match: | Usado para controle de simultaneidade. Algumas chamadas à API exigem a passagem da ETag por meio do cabeçalho If-Match. A ETag geralmente está no recurso e, portanto, requer obter por meio de GET a mais recente. Para obter mais informações, consulte as informações ETag em Testar e depurar. | string |
| MS-PartnerCenter-Aplicação | 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:
| parâmetro | Descrição | 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 a id-potency. Se houver um tempo limite, a chamada de repetição deverá incluir o mesmo valor. Após receber uma resposta (êxito ou falha empresarial), 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 |