|
Avtodispetcher ru Api ставок к грузам
|
| Sana | 15.10.2020 | | Hajmi | 27 Kb. | | #12120 |
Обязательные http-заголовки запросов:
Accept: application/json
Content-type: application/json
Authorization: Bearer someTokenHere
Тело запроса (json) в кодировке UTF-8.
Получение списка ставок к своим грузам (постранично)
GET-запрос https://api.avtodispetcher.ru/v1/cargobids?page=1
Ответ с http-кодом 200 содержит json со списком грузов. Список содержит полную информацию по каждому из грузов. Нет необходимости получать полную информацию по каждому из грузов отдельным запросом.
Пример ответа:
{
"count": 5, // количество ставок на текущей странице
"total": 5, // количество ставок суммарно на всех страницах
"page": 1 // номер текущей страницы
"page_count": 1, // количество страниц
"page_size": 25, // количество элементов на одну страницу
"_links": { // HAL-гиперссылки для листания списка
"self": {
"href": "https://api.avtodispetcher.ru/v1/cargobids?page=1"
},
"first": {
"href": "https://api.avtodispetcher.ru/v1/cargobids"
},
"last": {
"href": "https://api.avtodispetcher.ru/v1/cargobids?page=1"
}
},
"_embedded": {
"cargobid": [
{ // первая ставка
"id": 220, // id ставки в нашей БД
"bid": 15000, // денежная величина ставки
"currency": "RUR", // валюта ставки
"description": "Возьму догрузом, недорого. Звоните.", // комментарий к ставке
"creationDate": "2016-08-12T12:13:45+03:00", // дата создания ставки в формате ISO8601+UTC
"cargo": { // секция груза, к которому сделана ставка
"id": 1234,
"route": [...], // подробное описание структуры груза смотрите в API грузов
"distance": 750,
"cargo": {...},
"price": {...},
"ready": {...},
"requirements": {...},
...
},
"contact": { // секция описания контактов персоны, сделавшей ставку
"name": "Николай Иванович",
"phones": ["79185215852"]
},
"_links": { // HAL-гиперссылка
"self": {
"href": "https://api.avtodispetcher.ru/v1/cargobids/220"
}
}
},
{ // вторая ставка ….
},
{ // третья ставка ….
}
]
}
}
| Получение списка ставок, сделанных в интервал времени
GET-запрос https://api.avtodispetcher.ru/v1/cargobids?page=1&minCreationDate=2017-12-14T12%3A39%3A29%2B03%3A00&maxCreationDate=2017-12-14T13%3A39%3A29%2B03%3A00
Оба параметра minCreationDate и maxCreationDate являются необязательными. Дата указывается в формате ISO8601+UTC
Формат ответа аналогичен простому списку ставок.
GET-запрос https://api.avtodispetcher.ru/v1/cargobids/345623
Ответ с http-кодом 200 содержит json с информацией о ставке
Ответ с http-кодом 404, если ставки нет
|
| |
