Добавление (редактирование) отзыва на чужой груз

Описание

Добавление либо редактирование отзыва на чужой груз.  

Структура URL

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

Результат

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

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

Прочитать подробнее о указанных ниже параметрах можно здесь.

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

Price

BODY+
CurrencyIdBODY+
NoteBODY 
PayAttributesBODY 
PrepayPercentBODY 
PayAfterMaxBankDaysBODY 
LoadingDateBODY 

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

Запрос

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

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

 

 

Требования

  • отзыв нельзя добавить к своему грузу;
  • вы имеете право оставлять отзывы в соответствии с оплаченными услугами:
    • если у вас оплачена услуга "Все грузы", вы можете оставлять отзывы для всех грузов;
    • если у вас оплачена услуга "Грузы по России", вы можете оставлять отзывы для всех грузов, у которых страна загрузки и разгрузки – Россия;
    • если у вас оплачена услуга "Грузы вне России", вы можете оставлять отзывы для всех грузов, у которых страна загрузки и страна разгрузки – не Россия;
    • если у владельца груза оплачена услуга "Грузы для всех", вы можете оставлять отзыв к данному грузу в любом случае.

Ответ

Ответ содержит добавленный отзыв, идентичный отправленному, в случае успеха, и ошибку в случае неудачи. 

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

Каждая ошибка кроме HTTP кода имеет уникальный строковый код. Подробнее..

HTTP код ответа
Код ошибки
Сообщение
200--Операция завершена успешно
400json_validation_errorОшибка валидации отзыва
400deserialization_errorОшибка десериализации тела запроса
401--Требуется авторизация
403access_denied_errorОшибка доступа
404load_not_found_errorГруз не найден