Получение отзывов только на свои грузы по ID

Описание

Получение отзывов на заданные грузы фирмы в виде словаря. На данный момент можно получить только встречные предложения.

Структура URL

HTTP метод: GET, ресурс: <base_url>/loads/responses/by-ids?dateFrom=<datetime>&loadIds=<id1>[&loadIds=<id2>...&loadIds=<idN>] 

Результат

Словарь, где ключ – id груза, а значение – массив структур "Отзыв на груз" Result, представляющий набор отзывов для данного груза, и Status, представляющий статус груза: если груз с таким id не найден у вашей фирмы, статус равен 0, иначе статус равен 1. Если у груза статус равен 0, то массив отзывов всегда пуст.  Список ключей словаря полностью совпадает со списком грузов, для которых были запрошены отзывы.

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

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

Дата в UTC, начиная с которой необходимо показывать отзывы. Если ничего не передано, значит показываем абсолютно все отзывы

Формат даты: yyyy-mm-ddThh:mm:ss<timezone_specifier>, где timezone_specifier обозначает спецификатор часового пояса, например:

  • 'Z' - дата в формате UTC. Пример, 2016-04-28T20:01:57Z;
  • '-hh:mm'  - Часовой пояс UTC-hh:mm. Пример UTC-1:  2016-04-28T20:01:57-01:00;
  • '%2Bhh:mm' - Часовой пояс UTC+hh:mm. Пример UTC+1: 2016-04-28T20:01:57%2B01:00;

Если модификатора часового пояса нет, дата отправляется в формате UTC+3(Москва)

URL 
loadIdsМассив id грузов, для которых нужно получить отзывы.URL 

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

Запрос

GET, http://api.ati.su/loads/responses/by-ids?dateFrom=2016-04-24T10:01:58Z&loadIds=1D9F2943-DA4D-E211-B493-14DAE93E0938&loadIds=962D7E61-2670-E611-A37F-005056C00008&loadIds=129F2943-DA4D-E211-B493-14DAE93E0938
При этом 

 

Ответ

Массив отзывов заданные грузы в виде словаря

 

 

 

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

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

HTTP код ответа
Код ошибки
Сообщение
200--Операция завершена успешно
401--Требуется авторизация