Добавление списка

Описание

Добавление нового списка фирм.

Структура URL

HTTP метод: POST, ресурс: <base_url>/v1.2/lists/firms

Результат

Структура FirmList, описывающая добавленный список.

Список параметров

НазваниеСпособ передачиОбязательный
nameBody+
typeBody- (по умолчанию 0)
descriptionBody-
personalBody- (по умолчанию false)
contact_idBody- (по умолчанию 0)
ati_idBody+

Более подробное описание параметров см на странице структура <Список фирм>

Пример запроса и ответа

Запрос

POST http://api.ati.su/v1.2/lists/firms/

{
  "name": "Новый список",
  "type": 0,
  "description": "",
  "personal": false,
  "contact_id": -1,
  "ati_id": 10046694
}

Ответ

Если добавление произойдет успешно, то вернется добавленный пустой список.

{
  "id": "c01f21d6-4e14-4718-9bb1-e4974725df8f",
  "name": "Новый список",
  "type": 0,
  "description": "",
  "personal": false,
  "contact_id": -1,
  "ati_id": "10046694",
  "elements": []
}

Список ответов сервера

Код ответаОписание
200Операция завершена успешно
400Данные, переданные пользователем, некорректны
404Объект не найден
403Доступ запрещен
401Не авторизован
500Во время выполнения запроса произошла ошибка