FM / api

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

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

Name	Size	Mode	Actions
auth.php	5270	0644	edit dl rm
callback.php	2741	0644	edit dl rm
detect_city.php	2996	0644	edit dl rm
detect_server.php	4448	0644	edit dl rm
index.php	3388	0644	edit dl rm
order_cancel.php	2573	0644	edit dl rm
order_create.php	6686	0644	edit dl rm
phone.php	2463	0644	edit dl rm
search.php	5311	0644	edit dl rm
tests.php	10157	0644	edit dl rm
tickets.php	1093	0644	edit dl rm

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

<h2><a class="btn btn-info" href="<?php echo URL;?>docs/api_dcu"><span class="glyphicon glyphicon-arrow-left"></span></a> Создание заказа</h2>
<br>
<h3>Введение</h3>
<br>
<b>POST</b> <?php echo API_URL;?>method/order_create/ <span class="glyphicon glyphicon-plus"></span> <a class="btn btn-info" href="<?php echo URL;?>docs/api_dcu/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>city_id</td><td><span class="glyphicon glyphicon-asterisk"></span></td><td>id города
        <a class="btn btn-default btn-xs" href="<?php echo URL;?>docs/api_dcu/page/detect_city">Определение города по координатам</a>
        <a class="btn btn-default btn-xs" href="<?php echo URL;?>docs/api_dcu/page/get_cities">Список городов</a></td>
    </tr>
    <tr>
        <td>adres</td><td><span class="glyphicon glyphicon-asterisk"></span></td><td>Адрес подачи</td>
    </tr>
    <tr>
        <td>house</td><td><span class="glyphicon glyphicon-asterisk" style="color:#00F;"></span> </td><td>Дом</td>
    </tr>
    <tr>
        <td>porch</td><td></td><td>Подъезд</td>
    </tr>
    <tr>
        <td>object</td><td></td><td>Тип адреса (0 - <span class="glyphicon glyphicon-asterisk" style="color:#00F;"></span> адрес <b>по умолчанию</b>, 1 - объект)</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> просчет <b>по умолчанию</b>, 1 - по городу (таксометру)</td>
    </tr>
    <tr>
        <td>saveadres</td><td></td><td>1 - Сохранить адрес подачи в адреса заказчика</td>
    </tr>
    <tr>
        <td>adresX</td><td><span class="glyphicon glyphicon-asterisk" style="color:#F00;"></span></td><td>Массив адресов подачи</td>
    </tr>
    <tr>
        <td>houseX</td><td><span class="glyphicon glyphicon-asterisk" style="color:#F0F;"></span></td><td>Массив номеров домов</td>
    </tr>
    <tr>
        <td>objectX</td><td><span class="glyphicon glyphicon-asterisk" style="color:#F0F;"></span></td><td>Массив типов объекта. (0 - <span class="glyphicon glyphicon-asterisk" style="color:#F0F;"></span> адрес <b>по умолчанию</b>, 1 - объект)</td>
    </tr>
    <tr>
        <td>options</td><td></td><td>Массив опций (только id). <a class="btn btn-default btn-xs" href="<?php echo URL;?>docs/api_dcu/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>дата предварительного заказа</td>
    </tr>
    <tr>
        <td>ontimetime</td><td><span class="glyphicon glyphicon-asterisk" style="color:#080;"></span></td><td>время предварительного заказа</td>
    </tr>
    <tr>
        <td>phone</td><td><span class="glyphicon glyphicon-asterisk"></span></td><td>Телефон заказчика в международном формате (+38... , +7...)</td>
    </tr>
    <tr>
        <td>fio</td><td></td><td>Имя заказчика</td>
    </tr>
    <tr>
        <td>addcost</td><td></td><td>Добавочная стоимость</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>
</table>
<div class="alert alert-info text-center">формат возвращаемых данных по умолчанию JSON</div>
<br>
<br>
<h3>Пример запроса:</h3>
<pre class="prettyprint linenums theme-mud-contrast">
<?php echo API_URL;?>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>
<?php //echo md5('api_id=1method=order_createrandom=98765e270b9a4510e46e5d21c763fe5dca4e2');?>

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

Введение

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

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

Название параметра	Обязательный параметр	Описание
city_id		id города Определение города по координатам Список городов
adres		Адрес подачи
house		Дом
porch		Подъезд
object		Тип адреса (0 - адрес по умолчанию, 1 - объект)
comment		Комментарий
thecity		0 - просчет по умолчанию, 1 - по городу (таксометру)
saveadres		1 - Сохранить адрес подачи в адреса заказчика
adresX		Массив адресов подачи
houseX		Массив номеров домов
objectX		Массив типов объекта. (0 - адрес по умолчанию, 1 - объект)
options		Массив опций (только id). Список опций
ontime		0 - обычный заказ по умолчанию, 1 - предварительный заказ
ontimedate		дата предварительного заказа
ontimetime		время предварительного заказа
phone		Телефон заказчика в международном формате (+38... , +7...)
fio		Имя заказчика
addcost		Добавочная стоимость
la		Долгота
lo		Широта
distance		Расстояние
cost		Просчитанная цена

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

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

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