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

Описание

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

Структура URL

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

Результат

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

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

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

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

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

Запрос

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

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

 

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

 

 

Требования

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

Ответ

 

1
2
3
4
5
6
{
  "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Не найден архивный груз с указанным идентификатором