Заголовки 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