Получение отзывов на любой груз по ID [1.0]

Описание

Получение отзывов на конкретный груз фирмы. Если груз твой, то вернутся все отзывы на твой груз с полной информацией. Если груз чужой, то вернутся все отзывы на этот груз, но все отзывы, кроме твоего, будут иметь в поле FirmInfo.Contact значение null. 

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

Структура URL

HTTP метод: GET, ресурс: <base_url>/loads/<id_груза>/responses?dateFrom=<datetime>

Результат

Массив структур "Отзыв на груз", представляющий набор отзывов для данного груза.

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

Название
Описание
Способ передачи параметра
Обязательный
id_грузаId груза, для которого необходимо получить отзывыURL+
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 

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

Запрос

GET,  http://api.ati.su/loads/cfc5e795-d763-40e9-80c7-a0c9018a0146/responses/ (от фирмы-владельца груза)ads/cfc5e795-d763-40e9-80c7-a0c9018a0146/responses/

Ответ

Массив отзывов на указанный груз фирмы

[
    {
        "ResponseId": "3de4ee1c-c74e-e811-8246-3497f6db722c",
        "LoadId": "cfc5e795-d763-40e9-80c7-a0c9018a0146",
        "LoadFirmId": 10007401,
        "FirmId": 10007402,
        "FirmName": "loadExp4",
        "ContactId": 0,
        "AddedAt": "2018-05-03T11:42:53.567Z",
        "UpdatedAt": "2018-05-03T11:42:53.567Z",
        "Price": 421343,
        "CurrencyId": 1,
		"CounterOfferSource": 4,
        "Note": ""
        "PayAttributes": 0,
        "PrepayPercent": 0,
        "PayAfterMaxBankDays": 0,
        "LoadingDate": null,
        "IsOutdated": false,
        "IsLoadPublished": false,
        "IsNoLoad": false,
        "AnnouncedCurrencyId": 0,
        "AnnouncedRate": 0,
        "FirmInfo": {
            "TotalScore": 0,
            "Status": 2,
            "FullFirmName": "loadExp4, АКОТ",
            "Contact": {
                "Id": 0,
                "Name": "Contact Contact Contact Contact Contact",
                "Telephone": "+7(911)4567654",
                "Email": "admin1294@mail.ru",
                "Icq": "123124353453",
                "Mobile": "+7(921)1235465",
                "SkypeName": "skypename",
                "CityId": 1,
                "Location": {
                    "CityId": 1,
                    "RegionId": 153,
                    "CountryId": 1,
                    "FullName": "Санкт-Петербург, Санкт-Петербург (регион), Россия",
                    "ShortName": "Санкт-Петербург",
                    "IsRegionalCenter": true,
                    "CitySize": 6,
                    "FiasId": "aad1469e-54ff-4605-af4f-f016c75b84d2",
                    "Attributes": 89061,
                    "CityName": "Санкт-Петербург",
                    "RegionName": "Санкт-Петербург (регион)",
                    "CountryName": "Россия",
                    "CountryCodeName": "RUS"
                }
            }
        }
    },
    {
        "ResponseId": "b5bedd0f-cd4e-e811-8246-3497f6db722c",
        "LoadId": "cfc5e795-d763-40e9-80c7-a0c9018a0146",
        "LoadFirmId": 10007401,
        "FirmId": 10007399,
        "FirmName": "loadExp1",
        "ContactId": 0,
        "AddedAt": "2018-05-03T12:25:28.623Z",
        "UpdatedAt": "2018-05-03T12:25:28.623Z",
        "Price": 421343,
        "CurrencyId": 1,
		"CounterOfferSource": 4,
        "Note": "",
        "PayAttributes": 0,
        "PrepayPercent": 0,
        "PayAfterMaxBankDays": 0,
        "LoadingDate": null,
        "IsOutdated": false,
        "IsLoadPublished": false,
        "IsNoLoad": false,
        "AnnouncedCurrencyId": 0,
        "AnnouncedRate": 0,
        "FirmInfo": {
            "TotalScore": 0,
            "Status": 2,
            "FullFirmName": "loadExp1, ИП",
            "Contact": {
                "Id": 0,
                "Name": "Contact",
                "Telephone": "",
                "Email": "admin1294@mail.ru",
                "Icq": "",
                "Mobile": "",
                "SkypeName": "",
                "CityId": null,
                "Location": {
                    "CityId": 0,
                    "RegionId": null,
                    "CountryId": null,
                    "FullName": "",
                    "ShortName": null,
                    "IsRegionalCenter": false,
                    "CitySize": 0,
                    "FiasId": null,
                    "Attributes": 0,
                    "CityName": null,
                    "RegionName": null,
                    "CountryName": null,
                    "CountryCodeName": null
                }
            }
        }
    }
]

Запрос 

GET, http://api.ati.su/loads/cfc5e795-d763-40e9-80c7-a0c9018a0146/responses/ (от одной из откликнувшихся фирм)

Ответ

Массив отзывов на указанный груз другой фирмы

[
    {
        "ResponseId": "3de4ee1c-c74e-e811-8246-3497f6db722c",
        "LoadId": "cfc5e795-d763-40e9-80c7-a0c9018a0146",
        "LoadFirmId": 10007401,
        "FirmId": 10007402,
        "FirmName": "loadExp4",
        "ContactId": 0,
        "AddedAt": "2018-05-03T11:42:53.567Z",
        "UpdatedAt": "2018-05-03T11:42:53.567Z",
        "Price": 421343,
        "CurrencyId": 1,
        "CounterOfferSource": 4,
        "Note": "",
        "PayAttributes": 0,
        "PrepayPercent": 0,
        "PayAfterMaxBankDays": 0,
        "LoadingDate": null,
        "IsOutdated": false,
        "IsLoadPublished": false,
        "IsNoLoad": false,
        "AnnouncedCurrencyId": 0,
        "AnnouncedRate": 0,
        "FirmInfo": {
            "TotalScore": 0,
            "Status": 2,
            "FullFirmName": "loadExp4, АКОТ",
            "Contact": {
                "Id": 0,
                "Name": "Contact Contact Contact Contact Contact",
                "Telephone": "+7(911)4567654",
                "Email": "admin1294@mail.ru",
                "Icq": "123124353453",
                "Mobile": "+7(921)1235465",
                "SkypeName": "skypename",
                "CityId": 1,
                "Location": {
                    "CityId": 1,
                    "RegionId": 153,
                    "CountryId": 1,
                    "FullName": "Санкт-Петербург, Санкт-Петербург (регион), Россия",
                    "ShortName": "Санкт-Петербург",
                    "IsRegionalCenter": true,
                    "CitySize": 6,
                    "FiasId": "aad1469e-54ff-4605-af4f-f016c75b84d2",
                    "Attributes": 89061,
                    "CityName": "Санкт-Петербург",
                    "RegionName": "Санкт-Петербург (регион)",
                    "CountryName": "Россия",
                    "CountryCodeName": "RUS"
                }
            }
        }
    },
    {
        "ResponseId": "b5bedd0f-cd4e-e811-8246-3497f6db722c",
        "LoadId": "cfc5e795-d763-40e9-80c7-a0c9018a0146",
        "LoadFirmId": 10007401,
        "FirmId": 10007399,
        "FirmName": "loadExp1",
        "ContactId": -1,
        "AddedAt": "2018-05-03T12:25:28.623Z",
        "UpdatedAt": "2018-05-03T12:25:28.623Z",
        "Price": 421343,
        "CurrencyId": 1,
        "CounterOfferSource": 4,
        "Note": "",
        "PayAttributes": 0,
        "PrepayPercent": 0,
        "PayAfterMaxBankDays": 0,
        "LoadingDate": null,
        "IsOutdated": false,
        "IsLoadPublished": false,
        "IsNoLoad": false,
        "AnnouncedCurrencyId": 0,
        "AnnouncedRate": 0,
        "FirmInfo": {
            "TotalScore": 0,
            "Status": 2,
            "FullFirmName": "loadExp1, ИП",
            "Contact": null
        }
    }
]


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

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

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