Получение новой структуры отзыва на архивные грузы по id [1.0]

Описание

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

Структура URL

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

Результат

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

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

Название
Описание
Способ передачи параметра
Обязательный
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/new/responses/by-ids?loadids=e06a2d78-bfbb-465f-82d8-fb29aaa1cc7f&loadids=980dc9a4-9c02-4e29-b132-ee14a697e0da&loadids=98d88e0d-e216-4ae4-89f7-5ee3776a19d4


При этом 

Ответ

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

{
    "98d88e0d-e216-4ae4-89f7-5ee3776a19d4": {
        "Status": 1,
        "Message": "Груз не найден",
        "Error": "load_not_found_error",
        "Reason": "Груз не найден"
    },
    "980dc9a4-9c02-4e29-b132-ee14a697e0da": {
        "Status": 0,
        "Message": "Ок",
        "Result": []
    },
    "e06a2d78-bfbb-465f-82d8-fb29aaa1cc7f": {
        "Status": 0,
        "Message": "Ок",
        "Result": [
            {
                "ResponseId": "f3e9eb90-66c2-e811-80be-003048db0139",
                "LoadId": "e06a2d78-bfbb-465f-82d8-fb29aaa1cc7f",
                "LoadFirmId": 1254147,
                "FirmId": 1723254,
                "FirmName": "Марков Всеволод Витальевич",
                "ContactId": 0,
                "AddedAt": "2018-09-27T15:04:01.86Z",
                "UpdatedAt": "2018-09-27T15:04:01.86Z",
                "Price": 999.99,
                "CurrencyId": 8,
                "NdsPrice": 888.88,
                "NdsCurrencyId": 3,
                "NotNdsPrice": 777.77,
                "NotNdsCurrencyId": 21,
                "CounterOfferSource": 4,
                "Note": "",
                "PayAttributes": 1,
                "PrepayPercent": 0,
                "PayAfterMaxBankDays": 0,
                "LoadingDate": null,
                "IsOutdated": false,
                "IsLoadPublished": false,
                "IsNoLoad": false,
                "AnnouncedCurrencyId": 0,
                "AnnouncedRate": 0,
                "FirmInfo": {
                    "TotalScore": 4.25,
                    "Status": 1,
                    "FullFirmName": "Марков Всеволод Витальевич, ИП",
                    "Contact": {
                        "Id": 0,
                        "Name": "Геннадий",
                        "Telephone": "+7 (900) 2954150",
                        "Email": "gennadij.m@mail.ru",
                        "Icq": "",
                        "Mobile": "+7 (910) 4328992",
                        "MobileOperator": null,
                        "SkypeName": "markov.ca",
                        "CityId": 5094,
                        "Location": {
                            "CityId": 5094,
                            "RegionId": 87,
                            "CountryId": 1,
                            "FullName": "Агинское, Забайкальский край, Россия",
                            "ShortName": "Агинское, Забайкальский край",
                            "IsRegionalCenter": false,
                            "CitySize": 1,
                            "FiasId": "62c73092-9096-4cf9-8f76-16e004dd0ac3",
                            "Attributes": 0,
                            "CityName": "Агинское",
                            "RegionName": "Забайкальский край",
                            "CountryName": "Россия",
                            "CountryCodeName": "RUS"
                        }
                    },
                    "Inn": "800100000856"
                }
            }
        ]
    }
}

 

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

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

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