FM / api

/var/www/doncode.com.ua/www/views/docs/api_dcc/

/var/www/doncode.com.ua/www/views/docs/api_dcc

Name	Size	Mode	Actions
adres_list.php	2449	0644	edit dl rm
auth.php	5529	0644	edit dl rm
balance_list.php	2467	0644	edit dl rm
cars_list.php	2921	0644	edit dl rm
delete_card.php	2754	0644	edit dl rm
get_adresses.php	2443	0644	edit dl rm
index.php	11414	0644	edit dl rm
map.php	2425	0644	edit dl rm
option_list.php	2260	0644	edit dl rm
orders_list.php	2629	0644	edit dl rm
order_cancel.php	2981	0644	edit dl rm
order_create.php	5830	0644	edit dl rm
order_status.php	5214	0644	edit dl rm
ping.php	1983	0644	edit dl rm
rate.php	3142	0644	edit dl rm
reverse.php	4010	0644	edit dl rm
route.php	3716	0644	edit dl rm
route_adresses.php	4161	0644	edit dl rm
save_card.php	3356	0644	edit dl rm
search.php	5367	0644	edit dl rm
settings.php	2603	0644	edit dl rm
settings_save.php	2777	0644	edit dl rm
sms_accept.php	3667	0644	edit dl rm
sms_send.php	2615	0644	edit dl rm
status_list.php	3460	0644	edit dl rm
tarifs_list.php	2536	0644	edit dl rm
tests.php	15917	0644	edit dl rm

Edit: /var/www/doncode.com.ua/www/views/docs/api_dcc/order_create.php (5830B)

<h2><a class="btn btn-info" href="<?php echo URL;?>docs/api_dcc"><span class="glyphicon glyphicon-arrow-left"></span></a> Создание заказа</h2>
<br>
<h3>Введение</h3>
<br>
<b>POST</b> http://<?php echo session::get('taxi_host').':'.session::get('taxi_port');?>/method/order_create/ <span class="glyphicon glyphicon-plus"></span> <a class="btn btn-info" href="<?php echo URL;?>docs/api_dcc/page/auth">Авторизация</a>
<br><br>
<h3>Параметры запросов</h3>
<table class="table table-hover">
    <thead>
    <tr class="active">
        <th><b>Название параметра</b></th>
        <th><b>Обязательный параметр</b></th>
        <th><b>Описание</b></th>
    </tr>
    </thead>
    <tr>
        <td>phone</td><td><span class="glyphicon glyphicon-asterisk"></span></td><td>Телефон заказчика в международном формате (+38... , +7...)</td>
    </tr>
    <tr>
        <td>adres</td><td><span class="glyphicon glyphicon-asterisk"></span></td><td>Адрес подачи</td>
    </tr>
    <tr>
        <td>comment</td><td></td><td>Комментарий</td>
    </tr>
    <tr>
        <td>thecity</td><td></td><td>0 - <span class="glyphicon glyphicon-asterisk" style="color:#F00;"></span> просчет поездки, 1 - по городу (таксометру <b>по умолчанию</b>)</td>
    </tr>
    <tr>
        <td>adresX</td><td><span class="glyphicon glyphicon-asterisk" style="color:#F00;"></span></td><td>Адреса подачи (adres2,adres3,adres4,adres5)</td>
    </tr>
    <tr>
        <td>options</td><td></td><td>Массив опций (только id). <a class="btn btn-default btn-xs" href="<?php echo URL;?>docs/api_dcc/page/option_list">Список опций</a></td>
    </tr>
    <tr>
        <td>ontime</td><td></td><td>0 - обычный заказ <b>по умолчанию</b>, 1 - <span class="glyphicon glyphicon-asterisk" style="color:#080;"></span> предварительный заказ</td>
    </tr>
    <tr>
        <td>ontimedate</td><td><span class="glyphicon glyphicon-asterisk" style="color:#080;"></span></td><td>дата предварительного заказа <b>2015-12-15</b></td>
    </tr>
    <tr>
        <td>ontimetime</td><td><span class="glyphicon glyphicon-asterisk" style="color:#080;"></span></td><td>время предварительного заказа <b>00:15</b></td>
    </tr>
    <tr>
        <td>name</td><td></td><td>Имя заказчика</td>
    </tr>
    <tr>
        <td>addcost</td><td></td><td>Добавочная стоимость</td>
    </tr>
    <tr>
        <td>bn</td><td></td><td>0 - наличные <b>по умолчанию</b>, 1 - безнал</td>
    </tr>
    <tr>
        <td>card</td><td></td><td>последние 4 цифры карточки</td>
    </tr>
    <tr>
        <td>la</td><td><span class="glyphicon glyphicon-asterisk" style="color:#F00;"></span></td><td>Долгота</td>
    </tr>
    <tr>
        <td>lo</td><td><span class="glyphicon glyphicon-asterisk" style="color:#F00;"></span></td><td>Широта</td>
    </tr>
    <tr>
        <td>distance</td><td><span class="glyphicon glyphicon-asterisk" style="color:#F00;"></span></td><td>Расстояние</td>
    </tr>
    <tr>
        <td>cost</td><td><span class="glyphicon glyphicon-asterisk" style="color:#F00;"></span></td><td>Просчитанная цена</td>
    </tr>
    <tr>
        <td>car_id</td><td></td><td>Назначить машину</td>
    </tr>
</table>
<div class="alert alert-info text-center">формат возвращаемых данных по умолчанию JSON</div>
<br>
<br>
<h3>Пример запроса:</h3>
<pre class="prettyprint linenums theme-mud-contrast">
http://<?php echo session::get('taxi_host').':'.session::get('taxi_port');?>/method/order_create/api_id/123/random/98765/sig/629e2dee3aaf6e0c43b189b888e7a16f
</pre>
В данном примере API получает запрос order_create ("создание заказа")<br>
<h3>Пример ответа:</h3>
<pre class="prettyprint linenums theme-mud-contrast">
<?php
        $json = null;
        $json['error'] = 0;
        $json['response']['method'] = 'order_create';
        echo json_encode($json, JSON_PRETTY_PRINT);
    ?>
</pre>
Ответ по умолчанию приходит в формате JSON в кодировке UTF-8<br>
<h3>Пример ответа (сообщение об ошибке):</h3>
<pre class="prettyprint linenums theme-mud-contrast">
<?php
        $json = null;
        $json['error'] = 101;
        $json['error_msg'] = 'Adres length < 2';
        $json['fail'] = 'Адрес не может состоять меньше 2 символов';
        $json['failid'] = 'adres';
        $json['focus'] = 'adres';
        echo bootstrap::json_encode__($json, JSON_PRETTY_PRINT);
    ?>
</pre>
<br>
<h3>Коды ошибок:</h3>
<table class="table table-hover">
    <thead>
    <tr class="active">
        <th><b>Код</b></th>
        <th><b>Описание</b></th>
    </tr>
    </thead>
    <tr>
        <td>0</td><td>OK</td>
    </tr>
    <tr>
        <td>100</td><td>Phone length < 10</td>
    </tr>
    <tr>
        <td>101</td><td>Adres length < 2</td>
    </tr>
    <tr>
        <td>102</td><td>House number empty</td>
    </tr>
    <tr>
        <td>103</td><td>Adres 2 length < 2</td>
    </tr>
    <tr>
        <td>104</td><td>House 2 number empty</td>
    </tr>
    <tr>
        <td>105</td><td>Create error</td>
    </tr>
</table>
<br>
<h3>Пример приложения:</h3>
<img width="400" src="/public/images/api_docs/search_car.png">

<?php //echo md5('api_id=1method=order_createrandom=98765e270b9a4510e46e5d21c763fe5dca4e2');?>

Создание заказа

Введение

POST http:///method/order_create/ Авторизация

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

Название параметра	Обязательный параметр	Описание
phone		Телефон заказчика в международном формате (+38... , +7...)
adres		Адрес подачи
comment		Комментарий
thecity		0 - просчет поездки, 1 - по городу (таксометру по умолчанию)
adresX		Адреса подачи (adres2,adres3,adres4,adres5)
options		Массив опций (только id). Список опций
ontime		0 - обычный заказ по умолчанию, 1 - предварительный заказ
ontimedate		дата предварительного заказа 2015-12-15
ontimetime		время предварительного заказа 00:15
name		Имя заказчика
addcost		Добавочная стоимость
bn		0 - наличные по умолчанию, 1 - безнал
card		последние 4 цифры карточки
la		Долгота
lo		Широта
distance		Расстояние
cost		Просчитанная цена
car_id		Назначить машину

формат возвращаемых данных по умолчанию JSON

Пример запроса:

http:///method/order_create/api_id/123/random/98765/sig/629e2dee3aaf6e0c43b189b888e7a16f

В данном примере API получает запрос order_create ("создание заказа")

Пример ответа:

Ответ по умолчанию приходит в формате JSON в кодировке UTF-8

Пример ответа (сообщение об ошибке):

Коды ошибок:

Код	Описание
0	OK
100	Phone length < 10
101	Adres length < 2
102	House number empty
103	Adres 2 length < 2
104	House 2 number empty
105	Create error