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

Описание

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

Структура URL

HTTP метод: GET, ресурс: <base_url>/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/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--Операция завершена успешно
401--Требуется авторизация