Получение отзывов на архивные грузы по id

Описание

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

Структура URL

HTTP метод: GET, ресурс: <base_url>/unpublished-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/unpublished-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
При этом 

 

Ответ

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

 

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
  "1D9F2943-DA4D-E211-B493-14DAE93E0938": {
    "Status": 1,
    "Result": [
      {
        "ResponseId""32c32943-da4d-e211-b493-14dae93d0938",
        "LoadId""1e9f2923-da4d-e211-b423-14dae93e0938",
        "FirmId": 10990,
        "ContactId": 0,
        "AddedAt""2016-05-29T15:01:58.22Z",
        "UpdatedAt""2016-05-29T15:01:58.22Z",
        "Price": 1001,
        "CurrencyId": 1,
        "Note"null,
        "PayAttributes": 0,
        "PrepayPercent": 0,
        "PayAfterMaxBankDays": 1,
        "LoadingDate"null,
        "IsOutdated"false
      },
      {
        "ResponseId""36c32943-da4d-e211-b493-14dae93e0938",
        "LoadId""1e9f2943-da4d-e211-b493-14dae93e0938",
        "FirmId": 131231,
        "ContactId": 0,
        "AddedAt""2016-05-29T15:01:58.24Z",
        "UpdatedAt""2016-05-29T15:01:58.24Z",
        "Price": 100,
        "CurrencyId": 1,
        "Note"null,
        "PayAttributes": 0,
        "PrepayPercent": 0,
        "PayAfterMaxBankDays": 1,
        "LoadingDate"null,
        "IsOutdated"false
      }
    ]
  },
  "962D7E61-2670-E611-A37F-005056C00008": {
    "Status": 1,
    "Result": []
  },
  "129F2943-DA4D-E211-B493-14DAE93E0938": {
    "Status": 0,
    "Result": []
  }
}

 

 

 

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

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

HTTP код ответа
Код ошибки
Сообщение
200--Операция завершена успешно
400validation_errorМассив ids не должен быть пуст или содержать неверный guid
401--Требуется авторизация