Заголовки REST и ответов Центра партнеров, поддерживаемые REST API Центра партнеров
Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government
REST API Центра партнеров поддерживает следующие заголовки HTTP-запроса и ответа. Не все вызовы API принимают все заголовки.
Заголовки запросов REST
REST API Центра партнеров поддерживает следующие заголовки HTTP-запросов, поддерживаемые REST API Центра партнеров.
| Верхний колонтитул | Description | Тип значения |
|---|---|---|
| Авторизация: | Обязательно. Токен проверки подлинности в формате "Bearer <токен>". | строка |
| Если вы выбрали Accept (Принять): | Указывает тип запроса и ответа, application/json. | строка |
| MS-RequestId: | Уникальный идентификатор, используемый для обеспечения эффективности идентификации. Если время ожидания истекло, вызов повторных попыток должен содержать то же значение. После получения ответа (об успешном или неудачном выполнении) значение необходимо заново задать для следующего вызова. | GUID |
| MS-CorrelationId: | Уникальный идентификатор вызова, полезный для журналов и трассировки сети в целях устранения ошибок. Значение необходимо заново задавать для каждого вызова. Все операции должны включать этот заголовок. Дополнительные сведения см. в разделе "Идентификатор корреляции" в разделе "Тест и отладка". | GUID |
| MS-Contract-Version: | Обязательно. Указывает версию запрошенного API; Обычно это значение является версией API: версия 1, если иное не указано в разделе "Сценарии ". | строка |
| If-Match: | Используется для контроля параллелизма. Некоторые вызовы API требуют передавать ETag в заголовке If-Match. ETag обычно включается в ресурс, поэтому необходимо получить актуальное значение с помощью операции GET. Дополнительные сведения см. в разделе "Сведения об ETag" в разделе "Тест" и "Отладка". | строка |
| MS-PartnerCenter-Application | Необязательно. Указывает имя приложения, использующего REST API Центра партнеров. | строка |
| X-Locale: | Необязательно. Указывает язык, в котором возвращаются ставки. Значение по умолчанию — en-US. Список поддерживаемых значений см. в разделе "Поддерживаемые языки и языковые стандарта Центра партнеров". | строка |
Заголовки ответов REST
REST API Центра партнеров может возвращать следующие заголовки ответа HTTP:
| Верхний колонтитул | Description | Тип значения |
|---|---|---|
| Если вы выбрали Accept (Принять): | Указывает тип запроса и ответа, application/json. | строка |
| MS-RequestId: | Уникальный идентификатор, используемый для обеспечения эффективности идентификации. Если время ожидания истекло, вызов повторных попыток должен содержать то же значение. После получения ответа (об успешном или неудачном выполнении) значение необходимо заново задать для следующего вызова. | GUID |
| MS-CorrelationId: | Уникальный идентификатор для вызова. Это значение полезно для устранения неполадок журналов и трассировок сети для поиска ошибки. Значение необходимо заново задавать для каждого вызова. Все операции должны включать этот заголовок. | GUID |