• Получение списка ставок к своим грузам (постранично)
  • Получение списка ставок, сделанных в интервал времени
  • Получение одной ставки
  • ­Avtodispetcher ru Api ставок к грузам




    Download 27 Kb.
    Sana15.10.2020
    Hajmi27 Kb.
    #12120
    1. ­Avtodispetcher.ru API ставок к грузам

    Обязательные http-заголовки запросов:



    1. Accept: application/json

    2. Content-type: application/json

    3. Authorization: Bearer someTokenHere

    Тело запроса (json) в кодировке UTF-8.
          1. Получение списка ставок к своим грузам (постранично)


    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"

                       }

                   }

               },

               { // вторая ставка ….

               },

               { // третья ставка ….

               }

           ]

       }

    }

          1. Получение списка ставок, сделанных в интервал времени


    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



    Формат ответа аналогичен простому списку ставок.
          1. Получение одной ставки


    GET-запрос https://api.avtodispetcher.ru/v1/cargobids/345623

    • Ответ с http-кодом 200 содержит json с информацией о ставке

    • Ответ с http-кодом 404, если ставки нет


    Download 27 Kb.




    Download 27 Kb.

    Bosh sahifa
    Aloqalar

        Bosh sahifa



    ­Avtodispetcher ru Api ставок к грузам

    Download 27 Kb.