Коды ошибок REST в Центре партнеров

Статья
03/07/2025

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

Соответствующие роли: агент администрирования | Администратор выставления счетов | Агент helpdesk | Агент продаж | Администратор управления пользователями

REST API Центра партнеров возвращают объект JSON, содержащий код состояния. Этот код, указывающий, был ли ваш запрос успешным или почему он завершился ошибкой.

Успешные ответы

Код состояния 2xx указывает, что запрос клиента был успешно получен, понят и принят.

Коды состояния HTTP

Следующие коды состояния 4xx и 5xx указывают на ошибку:

400: неправильный запрос
401: Несанкционированный
403 Forbidden (запрещено):
404: не найдено
405: метод не разрешен
406: недопустимо
408: истечение времени ожидания запроса
409: конфликт
412: Предварительное условие не выполнено
429: слишком много запросов
500: внутренняя ошибка сервера
501: не реализовано
502: недопустимый шлюз
503: служба недоступна
504: время ожидания истекло для шлюза

Сообщения об ошибках

Любой ответ с кодом состояния 4xx или 5xx включает сообщение об ошибке с информацией об условиях возникновения этой ошибки для данного кода.

В следующей таблице и примере кода описывается схема ответа на ошибку:

Имя.	Тип	Описание
код	строка	Всегда возвращается. Указывает тип возникшей ошибки. Не является нулевым значением.
описание	строка	Всегда возвращается. Подробно описывает ошибку и предоставляет сведения об отладке. Ненулевое и непустое значение. Максимальная длина — 1024 символов.
данные	массив	Возвращается только для некоторых типов ошибок. Список объектов ошибок.
источник	строка	Всегда возвращается. Источник ошибки.

{
  "code": <string>,
  "description": <string>,
  "data": [

  ],
  "source": <string>
}
WWW-Authenticate: OAuth realm=urn:cpsvc:cpid:{some cid}