Поиск по сайту

API
Главная / API - Ошибки методов API

Ошибки методов API

Обновлено 21.10.2019
88 кб

Общая информация 

В документе описан формат ошибок методов API, а также приведен перечень общих ошибок, которые могут возникать при обращении к методам API.

Приведенный формат ошибок в настоящее время используется только для методов /v2/request и /v1/payments/link.

Формат ошибок

Формат ответа методов API в случае ошибок

Пример ответа

{  
   "metadata":{  
      "status":400,
      "detail":"abc",
      "generated_at":"2015-06-18 12:37:28"
   },
   "errors":[  
      {  
         "code":281016,
         "title":"ошибка упрощённой отправки",
         "detail":"контрагент с минимальным набором данных не может быть отправителем по заказу",
         "link":"https://dev.dellin.ru/api/ordering/request/#error_281016",
         "fields":["receiver"]
      },
      {  
         "code":281017,
         "title":"Недопустимое значение параметра",
         "detail":"Данный параметр может содержать только значения из списка доступных значений",
         "link":"https://dev.dellin.ru/api/ordering/request/#error_281017",
         "fields":["requester"],
         "validValues":[1, 2, 3]
      },
      {  
         "code":117004,
         "title":"значение не найдено в справочнике",
         "detail":"необходимо выбрать значение из соответствующего справочника",
         "link":"https://dev.dellin.ru/calculation/pickup/#error_117004",
         "fields":["requester"],
         "badValues":["0xa77fcf6a449164ed490133777a68bd00"]
      }
   ]
}
<response>
   <metadata>
      <status>400</status>
      <detail>abc</detail>
      <generated_at>2015-06-18 12:37:28</generated_at>
   </metadata>
   <errors>
      <code>281016</code>
      <title>ошибка упрощённой отправки</title>
      <detail>контрагент с минимальным набором данных не может быть отправителем по заказу</detail>
      <link>https://dev.dellin.ru/api/ordering/request/#error_281016</link>
      <fields>receiver</fields>
   </errors>
   <errors>
      <code>281017</code>
      <title>Недопустимое значение параметра</title>
      <detail>Данный параметр может содержать только значения из списка доступных значений</detail>
      <link>https://dev.dellin.ru/api/ordering/request/#error_281017</link>
      <fields>requester</fields>
      <validValues>1</validValues>
      <validValues>2</validValues>
      <validValues>3</validValues>
   </errors>
   <errors>
      <code>117004</code>
      <title>значение не найдено в справочнике</title>
      <detail>необходимо выбрать значение из соответствующего справочника</detail>
      <link>https://dev.dellin.ru/calculation/pickup/#error_117004</link>
      <fields>requester</fields>
      <badValues>0xa77fcf6a449164ed490133777a68bd00</badValues>
   </errors>
</response>

Описание параметров

Response
ПараметрТипОписание
metadataobjectИнформация об оформленной заявке
metadata.statusinteger

Эмуляция http-кода состояния

metadata.detailstringТекстовое описание ответа сервера
metadata.generated_atstringДата и время генерации ответа сервера
errorsarray of Response.ErrorsПеречень ошибок

Response.Errors
ПараметрТипОписание
codeintegerНомер ошибки
titlestring

Краткое описание ошибки

detailstringДетальное описание ошибки
linkstringСсылка на документацию
fieldsarray of stringСписок параметров в запросе к методу, вызвавших ошибку
validValuesarray of stringСписок доступных значений параметра
badValuesarray of stringСписок ошибочных значений, переданных в параметре

Описание общих ошибок API

Номер ошибкиhttp-кодКраткое описание ошибкиДетальное описание ошибки
100001415Некорректный content-typeДопустимые значения content-type: application/json (стандарт RFC4627) и text/xml (стандарт RFC3023)
100002404Метод не найденПроверьте правильность адреса метода
100003410Метод отключенЗапрошенный метод более не доступен
100004403Отсутствует доступ к методуДоступ к методу предоставляется по требованию. Для получения доступа обратитесь к персональному менеджеру или в техническую поддержку
100005429Количество запросов к методу превышеноПревышена допустимая частота запросов. Для увеличения лимита обратитесь к персональному менеджеру или в техническую поддержку
100006500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
101001401Ошибка авторизацииНе передан API-ключ
101002401Ошибка авторизацииПередан недействительный API-ключ
101003401Ошибка авторизацииТребуется передать параметр sessionID
101004401Ошибка авторизацииВремя жизни сессии истекло
101005401Ошибка авторизацииСессия не найдена или создана с другим API-ключом
101006401Ошибка авторизацииНеверный логин или пароль
101007401Ошибка авторизацииAPI-ключ заблокирован. Обратитесь в техническую поддержку
101008401Невалидный запросЗапрос не соответствует формату json
101009401Невалидный запросЗапрос не соответствует формату xml
110001400Неверный формат параметраЗначение, переданное в параметре, не соответствует требуемому формату
110002400Ошибка типизацииЗначение, переданное в параметре, имеет некорректный тип
110003400Отсутствует обязательный параметрОтсутствует обязательный параметр
110004400Не передан ни один из обязательных параметровВ запросе должен присутствовать хотя бы один параметр из совокупности, однако не указано ни одного
110005400Допустима передача только одного из параметровУказаны взаимоисключающие параметры, только один из которых может присутствовать в запросе
110006400Превышено ограничение на длину спискаКоличество элементов в списке превышает максимально допустимое
120001500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
120002500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
120101500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
120102500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
120201400Ошибка в параметрах запросаПереданы неправильные параметры в запрос
130001500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
130002500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
130008

400

Недопустимое значение параметраПроверьте правильность переданных значений
150001500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
150002500Внутренняя ошибка сервераПопробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки
180001400id отсутствует в адресной книгеУказанный в запросе id не найден в адресной книге. Проверьте правильность переданного значения