Обработка ошибок

При вызове метода возможно возникновение ошибок и предупреждений:

  • Ошибки, исключающие возможность выполнения запроса: неверный формат запроса (в том числе отсутствие обязательного параметра), неверный токен, недоступность сервера API и т. п.

  • Ошибки и предупреждения при выполнении операции с одним из объектов в запросе, которые не влияют на успешность выполнения операции с другими объектами. Подробно об ошибках операции читайте в разделе Операции над массивом объектов.

Коды и описания ошибок и предупреждений приведены в разделе Ошибки и предупреждения.

Примечание. Язык сообщений об ошибках определяется заголовком запроса Accept-Language.

Ошибки выполнения запроса

Если выполнение запроса невозможно, возвращается следующая структура:

<SOAP-ENV:Fault>
  <faultcode>SOAP-ENV:Client</faultcode>
  <faultstring>(string)</faultstring>
  <detail>
    <ns3:FaultResponse xmlns:ns3="http://direct.yandex.com/api/v5/general">
      <requestId>(string)</requestId>
      <errorCode>(int)</errorCode>
      <errorDetail>(string)</errorDetail>
    </ns3:FaultResponse>
  </detail>
</SOAP-ENV:Fault>
Параметр Тип Описание
Объект Fault
faultstring string Текст сообщения об ошибке.
detail ApiExceptionMessage Сведения об ошибке.
Объект ApiExceptionMessage
requestId string Уникальный идентификатор запроса, присвоенный сервером API Директа. Также передается в HTTP-заголовке RequestId.
errorCode int Числовой код ошибки.
errorDetail string Подробное описание ошибки.
Параметр Тип Описание
Объект Fault
faultstring string Текст сообщения об ошибке.
detail ApiExceptionMessage Сведения об ошибке.
Объект ApiExceptionMessage
requestId string Уникальный идентификатор запроса, присвоенный сервером API Директа. Также передается в HTTP-заголовке RequestId.
errorCode int Числовой код ошибки.
errorDetail string Подробное описание ошибки.