Добавление (редактирование) комментария к грузу [1.0]

Описание

Добавление либо редактирование комментария к грузу.  

Структура URL

HTTP метод: PUT, ресурс: <base_url>/loads/<id_груза>/comments

Результат

Структура "Комментарий", описывающая комментарий к грузу.

У изменённого комментария поменяется CommentId.

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

НазваниеСпособ передачи параметраОбязательный
LoadIdURL+
MessageBODY+

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

Запрос

PUT, http://api.ati.su/loads/039f2943-da4d-e211-b493-14dae93e0938/comments

Далее приведен пример JSON для добавления комментария к грузу.

"Комментарий к грузу 039f2943-da4d-e211-b493-14dae93e0938"

 

Требования

  • комментарий не может быть пустым
  • длина комментария не более 128 символов
  • если для фирмы включен режим раздельного доступа, то количество комментариев к одному грузу ограничено одним комментарием на контакт, иначе – одним комментарием на фирму;

Ответ

{
  "CommentId": "4727a54b-ca75-e611-80d8-10feed050c36",
  "Message": "Комментарий к грузу 039f2943-da4d-e211-b493-14dae93e0938",
  "ContactId": 0,
  "CommentDateTime": "2016-09-08T13:44:04.083Z"
}

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

Код ответаСообщение
200Операция завершена успешно
400Ошибка валидации при добавлении комментария
401Требуется авторизация
404Не найден груз с указанным идентификатором