API документация:
По многочисленным просьбам к нашему функционалу бота добавлена фукнция доступа по api.
Алгоритмы запросов пришлось "встраивать" в уже существующую логику запроса через телеграм, что бы поставщики отчетов могли работать в привычном для себя окружении.
1. Для получения токена доступа и стоимости пишите в л/с @vinvag
2. Что бы подать запрос в очередь на обработку нужно передать обязательные параметры:
- токен пользователя
- vin авто (строго 17 латинских символов без I,O,Q) .
- тип проверки - список доступных ниже.
- марка авто (для каждого типа свой набор марок).
- язык отчета (свой для каждой марки и типа проверки).
Не обязательные параметры:
- id телеграм для отправки уведомлений.
- email клиента (сервер может отправить отчет напрямую.)
- email ваш (если нужно поставим в копию, письма с отчетом)
Алгоритм работы:
Полученный от вас запрос, в зависимости от параметров будет передан нужному поставщику (сотруднику ОД)).
При получении его ответа(от несколько минут до несколько часов) будет передан методом (POST) + если указано на доп. параметры.
3. Типы запросов:
-- тип запроса "get_balance" запрос получения баланса
принимает только токен"
-- тип запроса "check_data_bmw_full" запрос дилеру БМВ
принимает марки "BMW" "Mini"
доступны языки "Русский" ,"Английский" ,"Польский", "Румынский" ,"Французский", "Немецкий"
*для этой марки производитель примерно в 5% авто не дает выгрузить отчет ни на каком языке кроме английского (тогда отчет придет на английском)
-- тип запроса "check_data_multibr_zapros" (многомарочный )
принимает марки Alfa Romeo Renault Jeep Infiniti Land Rover Nissan Mazda hyundai Honda Peugeot Citroen Fiat Jaguar Lexus Opel Toyota KIA Ford Porsche Mercedes-Benz
доступны языки "Русский" ,"Английский"
*примерно 5% ам доступен только Английский не зависимо от настроек.(Mercedes-Benz DSR отчет ())
-- тип запроса "check_elsa_pro_full" запрос дилеру VAG
принимает марки Audi SKODA SEAT Volkswagen
доступны языки "Русский" ,"Английский" ,"Польский", "Румынский" ,"Французский", "Немецкий"
*обратить внимание у разных дилеров разный доступ - и vin должен соответствовать марке.
-- тип запроса "check_CarVertical"
единственный не привязан к марке авто (примает любые или без указания)
доступны языки "Русский" ,"Английский" ,"Польский", "Румынский" ,"Французский", "Немецкий"
-- тип запроса "check_data_mercedes_eva" отдельный тип отчета для марки Mercedes-Benz (чуть более расширенный достп чем DSR и "видит" G класс )
доступны языки "Английский"
-- тип запроса "check_erwin_full" запрос к базе электронных сервисных книжек VAG
принимает марки Audi SKODA SEAT Volkswagen
доступны языки "Английский"
-- тип запроса "check_etka_full" комплектация автомобиля в формате етка содержит расшифровку PR кодов автомобиля/дату производства и др.
принимает марки Audi SKODA SEAT Volkswagen MAN Porsche Bentley
доступны языки "Русский" ,"Английский"
-- тип запроса "check_nomer_dws" получить серийный номер двигателя (для таможни и учета) из базы ОД
принимает марки Audi SKODA SEAT Volkswagen Volvo Peugeot Nissan Jeep KIA Mercedes Opel Citroen Dodge Fiat hyundai
доступны языки "Английский"
пример кода запроса
url = 'https://example.com/api/processing_queue'
# Обязательные параметры
params = {
'token': 'ваш_токен',
'vin': 'XXXXXXXXXXXXXXXXX', # Замените на VIN авто
'check_type': 'тип_проверки',
'car_brand': 'марка_авто',
'report_language': 'язык_отчета'
}
# Необязательные параметры
optional_params = {
'telegram_id': 'id_телеграм',
'client_email': 'email_клиента',
'your_email': 'ваш_email'
}
response = requests.post(url, json={**params, **optional_params})
print(response.json()
для получения токена доступа, точек входа и другой информации пишите в телеграм @vinvag