Дела Идут для разработчиков

Коды ошибок API

Все ответы от сервера приходят в формате JSON. В каждом ответе содержится ключ status. Первые три цифры статуса, до разделяющей точки соответствуют кодам состояния HTTP. Цифры после запятой соответствуют внутренним кодам ошибок системы Дела Идут.

Список используемых кодов HTTP

  • 200 OK
  • 201 Created («создано»)
  • 400 Bad Request (некорректный запрос)
  • 401 Unauthorized (Неавторизованный доступ)
  • 403 Forbidden (Доступ запрещен)
  • 500 Internal server error (внутренняя ошибка сервера)

Внутренние коды ошибок

400.1 Некорректный запрос.

Не существует аккаунта привязанного к указанному префиксу prefix.delaidut.ru/api/v1/…

400.2 Некорректный запрос.

Ошибка возникает в следующих случаях:

  1. Неверный метод запроса (POST, GET, PUT, DELETE)
  2. Не существует обязательный параметр запрашиваемого метода

400.3 Некорректный запрос.

Размер загружаемого файла больше 10 Мбайт.

400.4 Некорректный запрос.

Сервис отключен. Для API клиента.

403.1 Срок подписки истек.

Необходимо оплатить доступ к системе Дела Идут на сайте delaidut.ru

403.2 Неверный логин или пароль.

Ошибка возникает в следующих случаях:

  1. В URI указан неверный префикс (prefix.delaidut.ru/api/v1/…)
  2. Указан неверный Логин пользователя
  3. Указан неверный пароль пользователя
  4. Пользователя не существует
  5. Пользователю запрещен доступ в систему администратором

403.3 Необходимо выполнить аутентификацию

Попытка вызвать метод api без предварительной аутентификации либо не передан уникальный ключ для текущей сессии пользователя

403.4 Недостаточно прав

У пользователя, прошедшего аутентификацию, недостаточно прав для выполнения операции

403.5 Возможность создания объектов заблокирована

Создание объектов заблокировано. Для разблокирования данного функционала пополните счет аккаунта.

403.6 Возможность создания дублей контактов заблокирована

На аккаунте включена блокировка создания контактов и в системе уже есть контакт с такой же почтой и/или телефоном

500.1 Ошибка сервера.

Не найден пользователь по идентификатору