Современная цифровая культура. Интеграции. API
API (application programming interface, программный интерфейс приложения) – набор методов для автоматического взаимодействия и обмена данными между программами.
Стандартизация процессов для перехода на взаимодействие на уровне API является одним из драйверов цифровой трансформации современных предприятий.
Разрабатывайте новые и интегрируйте существующие приложения, сервисы, сайты и базы данных с нашим программным интерфейсом.
Возможности
При необходимости, API может быть кастомизировано под каждого партнёра. Список текузих методов:
- загрузка/выгрузка новых лотов
- преобразование данных в форматы популярных торговых интернет-площадок
- отслеживание ставок и других событий
- статусы согласования и поставки
- получение контактов покупателей
- формирование документов
- статистические данные и рассчёты
- контроль и история изменений
- ...и другое, по запросу
Форматы данных
АВТОЭКСПРЕСС.ru / Car01.ru поддерживают обмен данными в следующих форматах:
Совместимость
Интерфейс совместим практически со всеми распространёнными языками программирования:
- Бекенд (серверная часть):
Java / Kotlin,
PHP,
C#,
Python - Фронтенд и мобильные приложения:
JavaScript / TypeScript,
React / React Native,
Dart / Flutter - и любыми другими, поддерживающими сетевое взаимодействие и форматы данных выше
Безопасность
-
На уровне сети:
только разрешённые IP-адреса и шифрование канала связи -
На уровне пользователя:
только по индивидуальному ключу доступа -
На уровне объекта:
только по признаку владения -
На уровне запроса:
цифровая подпись каждого обращения -
Отслеживание событий:
Подробное журналирование доступа и изменений, выявление аномалий
Пример объекта данных
Ниже представлена одна из реализаций объекта лота в формате JSON.
Необходимые поля, а также их порядок и условия доступа могут быть удалены, добавлены или модифицированы по согласованию с партнёром.
Подробная документация предоставляется при подключении.
# Один лот (автомобиль)
{
"car:id":"4088",
"car:vin":"XW8AT4NH1*******",
"city":"Москва",
"brand":"Skoda",
"model":"Rapid",
"color":"Белый",
"car:year":"2017",
"drive_type":"Передний",
"engine_type":"Бензиновый",
"gear_type":"АКПП",
"wheel":"левый",
"body_type":"Лифтбек",
"car:owner_id":"2007",
"car:owner_firm_id":"106",
"car:modification_string":"",
"car:engine_v":"1.4", # объём двигателя
"car:engine_p":"125", # мощность двигателя
"car:engine_type":"1", # [1 - бензин, 2 - дизель, ...]
"car:mileage":"22833", # пробег
"car:body_type":"17",
"car:doors":"5",
"car:gear_type":"1",
"car:color":"1",
"car:city":"1",
"car:region":"1",
"car:drive_type":"1",
"car:owners":"3",
"car:pts":"1",
"car:wheel":"1",
"car:about":"Авто после ДТП. Запчасти с авто отдельно не продаются. Цены по телефону не обсуждаются. Гарантии юридической чистоты. ",
"car:youtube":"4G6FhZQ9zAQ",
"car:act_number":"1561",
# Код состояния автомобиля в цепочке поставки
# 10 - заявка,
# 20 - поступил на стоянку,
# 30 - торгуется,
# ...,
# N - успешно продан и вывезен покупателем
"car:status":"20",
# Тип лота и транспортного средства
"car:lot_type":"1",
"car:transport_type":"1",
# Информация и настройки торгов
"car:circles":"2",
"car:in_slider":"0",
"car:sale_date_start":"2024-11-18",
"car:sale_date_stop":"2024-11-30",
"car:sale_datetime_stop":"2024-11-30T13:00",
"car:date_entered":"2024-11-18",
"car:date_taken":null,
"car:brand":"107",
"car:model":"1787",
"car:start_price":"10000", # Стартовая цена торгов
"car:now_price":"900000", # Блиц-цена
"car:parking":"1", # id из справочника парковок
"car:views":"23495",
"car:lastupdate":"2020-11-23 16:39:55",
"car:created":"2020-11-19 17:52:02",
# Организация и реквизиты
"org:name":"Корпорация Добра",
"org:id":"39",
"org:logo":"\/s\/img\/seller\/logo_sample.svg",
"org:full_name": "ООО Корпорация Добра",
"org:inn": "123*****",
"org:kpp": "123*****",
"org:okpo": "123*****",
"org:ogrn": "123*****",
"org:bank_name": "123*****",
"org:bank_bic": "123*****",
"org:bank_rs": "123*****",
"org:bank_ks": "123*****",
"org:gendir": "Иванов Иван Иванович",
"org:post_addr": "121000, улица Остроженка, дом 12, офис 3А",
"bet_q":"19", # Количество ставок
"actual_bet_q":"19", # Количество действительных ставок
"max_bet":"440000", # Максимальная ставка на данный момент
# Секция с деталями на замену, работами, покраской,
"works":{
"status":true,
"data":{
"detail":[
{
"name":"Облицовка бампера п",
"code":"60U807221H",
"q":1
},
{
"name":"Вентиляц решетка п",
"code":"60U8536779B9",
"q":1
},
{
"name":"Реш пр-тум фары пр",
"code":"5JA807682A9B9",
"q":1
},
{
"name":"Направл л бампер п",
"code":"5JA807049",
"q":1
},
{
"name":"Мелкие запчасти (2.0%)",
"code":"",
"q":1
}
],
"work":[
{
"name":"Кузовные деталь\/и антикоррозийная защита",
"code":"51 01 75 01)",
"q":20
},
{
"name":"Капот - антикор. обработка скр. полостей",
"code":"51 01 75 50",
"q":10
},
{
"name":"Лонжерон п л нанести антикорроз защ",
"code":"51 01 75 50",
"q":10
},
{
"name":"Акб - заменить (снята)",
"code":"27 06 55 50",
"q":10
},
{
"name":"Лонжерон передний внутр л в сборе замена",
"code":"50 79 55 00",
"q":800
},
{
"name":"Кондиц проверить",
"code":"87 01 01 00",
"q":50
},
{
"name":"Хладагент - слить\/залить",
"code":"87 03 17 00",
"q":60
}
],
"paint":[
{
"name":"Подг сопутст. раб. окр. пластика",
"code":"",
"q":3
},
{
"name":"Кронш креп бампера п.окр для нов.дет.эт i",
"code":"",
"q":9
},
{
"name":"Капот.окр для нов.дет.эт i",
"code":"",
"q":22
},
{
"name":"Подготовительные работы",
"code":"",
"q":13
}
]
}
},
# Массив фотографий
"photos": [
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2456.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2458.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2459.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2461.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2462.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2463.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2464.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2465.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2466.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2467.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2468.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2469.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2470.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2471.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2472.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2473.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2474.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2475.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2476.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2477.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2478.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2479.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2480.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2481.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2482.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2483.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2484.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2485.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2486.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2487.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2488.jpg",
"\/cars_files\/active\/4088\/opt\/АВТОЭКСПРЕСС_dscf2489.jpg"
]
}
Порядок подключения
- API предоставляется по запросу и дополнительному соглашению.
- Каждому пользователю API выдаётся индивидуальный ключ доступа (токен) к согласованным методам и лимиты на использование (количество запросов в день).
Вы можете получить бесплатную консультацию по вопросам внедрения и интеграции автоматического обмена данными через API у наших специалистов.
