API Руководство

Подбор каталога по VIN

Запрос на подбор каталога по VIN
HTTP запрос
GET http://api.autoxp.ru/api/vinident.aspx
Параметры:
vin [String] – идентификационный номер автомобиля
Ответ [XML]:

<marka>audi</marka>
<axp>520096</axp>
<model>A6 2.5 TDI</model>
<kuzov>седан</kuzov>
<door>4</door>
<yearstart>2001</yearstart>
<yearfinit>2004</yearfinit>
<obem>2496</obem>

Параметры ответа:
marka [String] - индекс марки
axp [String] – код AXP
model [String] – название модели
kuzov [String] – тип кузова
door [String] – кол-во дверей
yearstart [String] – год начала выпуска
yearfinit [String] - год окончания выпуска
obem [String] – объем двигателя
Отрицательные ответы сервера:
Length of the VIN must be 17! – длина VIN должна быть 17 знаков
VIN is not correct! – VIN не определён
Catalog by VIN not found! – не удаётся подобрать каталог для данного VIN

Каталоги

Запрос списка справочников
HTTP запрос
GET http://api.autoxp.ru/api/catalog.aspx
Параметры отсутствуют
Ответ [XML]:

<a>DAEWOO</a>
daewoo
<c>EU2016</c>

Параметры ответа:
a [String] - название марки
b [String] - индекс марки
c [String] - версия справочника
Пример:
http://api.autoxp.ru/api/catalog.aspx

Запрос списка моделей
HTTP запрос
GET http://api.autoxp.ru/api/catalog.aspx
Параметры:
marka [String] - индекс марки
Ответ [XML]:
<a>020</a>
001
<c>Nexia</c>
<d>хэтчбек (3дв.)</d>
<e>бензин</e>
<f>Nexia Sportiv</f>
<g>Механика-5ст.</g>
<h>1498/55/75</h>
1995-1996
Параметры ответа:
a [String] - первые три знака кода AXP
b [String] - последние три знака кода AXP
c [String] - серия
d [String] - тип кузова, кол-во дверей
e [String] - тип топлива
f [String] - название модели
g [String] - КПП
h [String] - объем и мощность двигателя
i [String] - период выпуска
Пример:
http://api.autoxp.ru/api/catalog.aspx?marka=daewoo

Запрос справочника
HTTP запрос
GET http://api.autoxp.ru/api/catalog.aspx
Параметры запроса:
marka [String] - индекс марки
axp [String] - код AXP
Ответ [XML]:
Параметры ответа:
model [Elements] - технические характеристики
c [String] - переменная
p [String] - значение
Описание переменных...

grdet [Elements] - группы деталей
g [String] - номер
n [String] - название
p [String] - код изображения

pictures [Elements] - иллюстрации
g [String] - номер группы деталей
p [String] - код
n [String] - название

details [Elements] - узлы и детали
g [String] - номер группы деталей
p [String] - код иллюстрации
s [String] - номер метки на иллюстрации
x [String] - X координата расположения метки на иллюстрации
y [String] - Y координата расположения метки на иллюстрации
n [String] - название
d [String] - код детали
o [String] - код операции (R-ремонт, E-замена, L-окраска, N-снятие/установка, что-то одно)
Пример:
http://api.autoxp.ru/api/catalog.aspx?marka=daewoo&axp=020001

Иллюстрации

[PNG] - популярный формат который поддерживают все браузеры
http://app.autoxp.ru/axp/[версия справочника]/[индекс марки]/[код иллюстрации]g.png
[GIF] - наименьший размер файла хорошо экономит трафик
http://app.autoxp.ru/axp/[версия справочника]/[индекс марки]/[код иллюстрации]g.gif
Пример:
http://app.autoxp.ru/axp/EU2016/daewoo/5D0132g.png

Выборка справочника

HTTP запрос
POST http://www.autoxp.ru/api/pscomplex.aspx
Параметры запроса:
state [String] - операция к выполнению: list-полуение списка выборок, send-отправка массива выборки, make-получение массива выборки, delete-удаление выборки , calc-калькуляция на основе выборки
guid [String] - универсальный идентификатор GUID
text [String] - массив выборки, необходимо только при выполнении операции send
docname [String] - название документа (выборки), необходимо только при выполнении операции send
index [Integer] - индекс выборки, необходимо только при выполнении операции make, delete, calc
Отрицательные ответы сервера:
Identification error! - GUID указан не верно или был изменен IP
Identification error! 02 - количество расчетов превышает допустимое число
Identification error! 03 - срок действия услуги истёк
Index is not correct! - запрашиваемый индекс указан не корректно
Index not found! - запрашиваемый индекс не найден
No input data! - выборка справочника пустая
Old version catalog used! - использован каталог старой версии

Массив выборки - это набор данных в виде списка значений, состоит из трёх блоков (пример). Первый блок - перечень полей необходимый для расчета калькуляции, где указана переменная поля и его содержимое. Второй блок - выборка справочника согласно структуре ПС:Комплекс. Третий блок - перечень комплектации ТС. Более подробное описание в разделе Примеры

Результат операции CALC
Ответ [XML]:
works [Elements] - ремонт/замена
a [String] - наименование
b [String] - стоимость
c [String] - нормо-час
d [String] - кол-во
e [String] - сумма
f [String] - номер

paints [Elements] - окраска/контроль
a [String] - наименование
b [String] - стоимость
c [String] - нормо-час
d [String] - кол-во
e [String] - сумма
f [String] - номер

parts [Elements] - запасные части
a [String] - наименование
b [String] - стоимость
c [String] - кол-во
d [String] - сумма
e [String] - износ (%)
f [String] - сумма (с износом)
g [String] - номер

materials [Elements] - материалы
a [String] - наименование
b [String] - стоимость
c [String] - кол-во
d [String] - сумма
e [String] - номер

Авторизация

HTTP запрос
GET http://www.autoxp.ru/api/authorize.aspx
Параметры запроса:
state [String] - операция к выполнению: getcount-количество расчетов в текущем месяце, finishdate-дата окончания доступа к API
guid [String] - универсальный идентификатор GUID
Отрицательные ответы сервера:
Identification error! - GUID указан не верно или был изменен IP
Identification error! 03 - срок действия услуги истёк