|
Позволяет в хронологическом порядке получить данные от установленных в автомобиле датчиков температуры. На одном автомобиле может быть
установлено несколько датчиков.
К критериям выборки относится временной интервал.
Запрос и получение данных с сервера происходит по протоколу http.
URL: http://api.car-online.ru/do?data=temperature&skey=<ключ>&<другие параметры>
| Параметр | Описание | Значения | Обязательность |
| data | Тип требуемой операции | contactId | Да |
| skey | Уникальный секретный ключ пользователя и его устройства | кодовая строка | Да |
| pattern | Шаблон представления данных с сервера | Идентификатор шаблона (по умолчанию, 215) | Нет |
| begin | Дата/время начала выборки данных | Дата и время в формате ddMMyyyy_HHmmss. Например, 23072009_114059 - 23 июля 2009 года 11 часов 40 минут 59 секунд. (по умолчанию, текущий день с нуля часов) | Нет |
| end | Дата/время окончания выборки данных | Дата и время в формате ddMMyyyy_HHmmss. Например, 23072009_114059 - 23 июля 2009 года 11 часов 40 минут 59 секунд. (по умолчанию, до конца текущего дня) | Нет |
| error_p | Шаблон представления ошибки от сервера | Идентификатор шаблона (по умолчанию, 1) | Нет |
Ответ с сервера формируется на основе заданного шаблона представления. Все данные закодированы таблицей UTF-8.
В случае необходимости можно задавать атрибут contentType, указывающий на тип получаемой информации для служебных целей
(например, чтобы корректно отображал браузер). Распространенные типы контента: text/html (информация представлена в html-формате) и
text/xml (xml-разметка).
Для получения данных с сервера нужно определить в каком формате их сформировать. Для этого необходимо задать шаблон.
Вы можете использовать один из стандартных шаблонов Car-Online, либо создать свой.
Для набора данных от датчиков температуры - это строка символов, описывающая одно значение от одного датчика температуры. В данную строку необходимо вставлять требуемые атрибуты.
Шаблон может иметь любой формат (xml, просто текст..). Вы можете настраивать только нужные вам атрибуты.
В шаблоне допускается повторное использование одного и того же атрибута.
| Атрибут | Описание | Значение |
| @value | Значение температуры | Целое число |
| @datetime | Дата/время события, к которому относится значение датчика температуры | Дата и время в формате ddMMyyyy_HHmmss. Например, 23072009_114059 - 23 июля 2009 года 11 часов 40 минут 59 секунд. |
| @eventid | Номер события, к которому относится значение от датчика температуры | Целое число |
| @sensornumber | Номер датчика температуры(на одном автомобиле может быть установлено несколько датчиков) | Целое число |
В случае возникновения ошибок сервер отсылает информацию о возникшей проблеме. Чтобы получать в нужном виде эти сведения можно настроить
соответствующий шаблон.
| Атрибут | Описание | Значение |
| @code | Уникальный код ошибки | Целое число |
| @message | Сообщение об ошибке | Строка |
Ниже представлены наиболее распространенные случаи использования экспорта данных для ContactID. В качестве тестируемого устройства
используется PGSM.
http://api.car-online.ru/do?data=temperature&skey=3d46e605FCe45e6125332D9da415c9
Ответ
<temperature value="9" datetime="18102011_004103" eventid="113746074" sensornumber="19"/>
<temperature value="8" datetime="18102011_013548" eventid="113785158" sensornumber="19"/>
<temperature value="7" datetime="18102011_024825" eventid="113827997" sensornumber="19"/>
<temperature value="6" datetime="18102011_044045" eventid="113898737" sensornumber="19"/> ....
http://api.car-online.ru/do?data=temperature&skey=3d46e605FCe45e6125332D9da415c9&content=xml
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<root>
<temperature value="9" datetime="18102011_004103" eventid="113746074" sensornumber="19"/>
<temperature value="8" datetime="18102011_013548" eventid="113785158" sensornumber="19"/>
<temperature value="7" datetime="18102011_024825" eventid="113827997" sensornumber="19"/>
<temperature value="6" datetime="18102011_044045" eventid="113898737" sensornumber="19"/> .... <temperature value="23" datetime="18102011_191329" eventid="115554865" sensornumber="19"/>
<temperature value="22" datetime="18102011_192142" eventid="115567715" sensornumber="19"/>
</root>
http://api.car-online.ru/do?data=temperature&skey=3d46e605FCe45e6125332D9da415c9&begin=10102011_160630&end=11102011_160730
Ответ
<temperature value="21" datetime="10102011_160857" eventid="99394765" sensornumber="19"/>
<temperature value="20" datetime="10102011_161746" eventid="99411837" sensornumber="19"/>
<temperature value="19" datetime="10102011_162755" eventid="99433024" sensornumber="19"/>
<temperature value="18" datetime="10102011_164049" eventid="99457270" sensornumber="19"/>
|