ПОИСК
 Аннотация
Позволяет в хронологическом порядке получить данные, ретранслированные из ContactID (DTMF-протокол для тревожных событий). Благодаря данной функции возможно самостоятельная обработка по оповещению возникших сигналов. К критериям выборки относится временной интервал.
Запрос и получение данных с сервера происходит по протоколу http.
 Формат запроса
URL: http://api.car-online.ru/do?data=contactId&skey=<ключ>&<другие параметры>
 Параметры запроса
ПараметрОписаниеЗначенияОбязательность
dataТип требуемой операцииcontactIdДа
skeyУникальный секретный ключ пользователя и его устройствакодовая строкаДа
patternШаблон представления данных с сервераИдентификатор шаблона (по умолчанию, 195)Нет
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, либо создать свой.
 Шаблон данных для ContactID
Для набора данных ContactID - это строка символов, описывающая одно значение с ContactID. В данную строку необходимо вставлять требуемые атрибуты. Шаблон может иметь любой формат (xml, просто текст..). Вы можете настраивать только нужные вам атрибуты. Для каждого значения ContactID из списка применяется указанный шаблон, которые разделяются новой строкой (то есть шаблоны отделяюся по переносу строки). В шаблоне допускается повторное использование одного и того же атрибута.
 Возможные атрибуты шаблона
АтрибутОписаниеЗначение
@eventidИдентификатор события, к которому относится значение ContactIDЦелое число
@datetimeДата/время события, к которому относится значение ContactIDДата и время в формате ddMMyyyy_HHmmss. Например, 23072009_114059 - 23 июля 2009 года 11 часов 40 минут 59 секунд.
@dateДат события, к которому относится значение ContactIDДата в формате ddMMyyyy. Например, 23072009 - 23 июля 2009 года.
@timeВремя события, к которому относится значение ContactIDВремя в формате HHmmss. Например, 114059 - 11 часов 40 минут 59 секунд.
@hexvalueРетранслированное значение с ContactIDСтрокое представление массива из 8 байт в hex-цифрах (16 цифр). Например, 123456780A1B2C3D.
 Шаблон ошибок от сервера
В случае возникновения ошибок сервер отсылает информацию о возникшей проблеме. Чтобы получать в нужном виде эти сведения можно настроить соответствующий шаблон.
 Возможные атрибуты шаблона
АтрибутОписаниеЗначение
@codeУникальный код ошибкиЦелое число
@messageСообщение об ошибкеСтрока
 Примеры
Ниже представлены наиболее распространенные случаи использования экспорта данных для ContactID. В качестве тестируемого устройства используется PGSM.
 Простой запрос на получение данных ContactID текущего дня в стандартном виде
http://api.car-online.ru/do?data=contactId&skey=914Ff68c6Cb5b65F535b254bb63E15
Ответ
<contactId event="1171109450" date="07042010_160609" value="123456780A1B2C3D"/>
<contactId event="1171112075" date="07042010_160609" value="123456780A1B2C3D"/>
<contactId event="1171113755" date="07042010_160717" value="123456780A1B2C3D"/>
<contactId event="1171114381" date="07042010_160717" value="123456780A1B2C3D"/>
<contactId event="1171220323" date="07042010_162601" value="123456780A1B2C3D"/>
<contactId event="1171515179" date="07042010_162239" value="123456780A1B2C3D"/>
<contactId event="1171559722" date="07042010_162239" value="123456780A1B2C3D"/>
....
 Тот же запрос, но ответ в xml-представлении
http://api.car-online.ru/do?data=contactId&skey=914Ff68c6Cb5b65F535b254bb63E15&content=xml
Ответ
<?xml version="1.0" encoding="UTF-8"?>
 <root>
  <contactId event="1171109450" date="07042010_160609" value="123456780A1B2C3D"/>
  <contactId event="1171112075" date="07042010_160609" value="123456780A1B2C3D"/>
  <contactId event="1171113755" date="07042010_160717" value="123456780A1B2C3D"/>
  <contactId event="1171114381" date="07042010_160717" value="123456780A1B2C3D"/>
 ....
  <contactId event="1171220323" date="07042010_162601" value="123456780A1B2C3D"/>
  <contactId event="1171515179" date="07042010_162239" value="123456780A1B2C3D"/>
  <contactId event="1171559722" date="07042010_162239" value="123456780A1B2C3D"/>
 </root>
 Запрос на получение ContactID-информации за выбранный временной интервал
http://api.car-online.ru/do?data=contactId&skey=914Ff68c6Cb5b65F535b254bb63E15
&begin=07042010_160630&end=07042010_160730
Ответ
<contactId event="1171113755" date="07042010_160717" value="123456780A1B2C3D"/>
<contactId event="1171114381" date="07042010_160717" value="123456780A1B2C3D"/>
 Применение шаблона представления списка данных ContactID
http://api.car-online.ru/do?data=contactId&skey=914Ff68c6Cb5b65F535b254bb63E15
&pattern=196
Ответ
C:1171109450/07042010_160609/123456780A1B2C3D
C:1171112075/07042010_160609/123456780A1B2C3D
C:1171113755/07042010_160717/123456780A1B2C3D
C:1171114381/07042010_160717/123456780A1B2C3D
C:1171220323/07042010_162601/123456780A1B2C3D
C:1171515179/07042010_162239/123456780A1B2C3D
C:1171559722/07042010_162239/123456780A1B2C3D
....
© 2009 Magic Systems. Все права защищены.