Запрос GET_SHORT_INFO



С помощью запроса get_short_info можно получить самую основную информацию по поездке. Выдачу этого запроса предполагается использовать для формирования уведомлений для пассажиров, либо для вывода информации о перевозке на сайте.

Запрос выполняется без авторизации, но с обязательной передачей уникального кода заявки (unique_id), который может быть получен с помощью метода view_order.

Запрос возвращает детали поездки только в случае, если текущая дата находится в промежутке не ранее 10 дней до поездки и не позднее 10 дней после поездки.

Параметры запроса:

action=get_short_info
hash_code={unique_id}

Ответ сервера может содержать и другие поля, не описанные в настоящей документации.
Если это не оговорено в техническом задании на интеграцию, такие поля следует игнорировать.
Порядок полей в ответе может меняться.

Ответ на запрос содержит информацию о заявке, либо код ошибки:

411 - заявка не доступна для просмотра на текущую дату
410 - не корректный код заявки

Поля в ответе:

id - номер заявки в системе

transfer - тип заявки (если да, то трансфер, если нет или пустой - то аренда)
table - надпись на табличке для встречи
datetime1 - ожидаемое время начала выполнения заявки (время подачи), формат ГГГГ-ММ-ДД ЧЧ:ММ:СС
datetime2 - ожидаемое время окончания выполнения заявки, формат ГГГГ-ММ-ДД ЧЧ:ММ:СС

transport - тип транспорта (например, Автобус)
class - класс выбранного типа транспорта (например, Бизнес класс до 50 мест)
car - наименование фактического ТС по заявке
car_number - госномер фактического ТС по заявке
driver_phone - номер телефона фактического водителя по заявке, формат 7ХХХХХХХХХХ
driver_name - фамилия и имя фактического водителя по заявке

pass_kol - количество пассажиров, целое число

passangers - массив с данными пассажиров
    name - ФИО пассажира (например, Иванов И.И.)
    phone - контактный телефон пассажира в формате 7ХХХХХХХХХХ

route - массив точек маршрута, где первая - это место подачи, а последняя - пункт назначения
    id - порядковый номер точки
    name - адрес или наименование точки маршрута, если адрес не может быть задан явно (Например, "пр.Римского-Корсакова 5/7" или "Стелла авиаторам, Дорога Жизни")
    lat - географическая широта точки
    lon - географическая долгота точки
    desc - описание точки машрута (любое тестовое описание или комментарии, например "Ambassador Hotel - припарковаться перед главным входом и ждать с табличкой у передней двери")

Пример запроса (в адаптации под GET):

http://{host}/?action=get_short_info&hash_code={unique_id}&gmode=1

Пример запроса CURL в среде PHP (методом POST):

<?php
$curl = curl_init();
curl_setopt_array($curlarray(
  CURLOPT_URL => "https://{host}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => array('action' => 'get_short_info','hash_code' => '{unique_id}'),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

 

Пример ответа сервера в формате JSON:

{
    "id""123456",
    "transfer""нет",
    "table""",
    "datetime1""2020-09-22 07:00:00",
    "datetime2""2020-09-22 10:00:00",
    "transport""Микроавтобус",
    "class""",
    "car""MB Sprinter 8м",
    "car_number""А123АА178",
    "driver_phone""79211234567",
    "driver_name""Юрий",
    "pass_kol""1",
    "passangers": [
        {
            "name""Иванов Иван",
            "phone""71234567890"
        },

    ],

    "route": [
        {
            "id"1,
            "name""Петергоф, Ропшинское ш, 3к2",
            "desc""07:00",
            "lat""59.8576622",
            "lon""29.9513928"
        },
        {
            "id"2,
            "name""ул. Здоровцева, д.33к1",
            "desc""07:20",
            "lat""59.8273741",
            "lon""30.1622186"
        },

    ]

}



Основные разделы



- Общие положения

- Запрос ADD_ORDER

- Запрос VIEW_ORDER

- Запрос DELETE_ORDER

- Запрос ORDERS_LIST

- Запрос VIEW_GPS

- Запрос GET_CLASSES

- Запрос GET_MANAGERS

- Запрос CREATE_MANAGER

- Запрос GET_SHORT_INFO


Нужна консультация? Обращайтесь!



it@automngm.ru - технический отдел