API для наладкі ў воблаку

Інтэгруйце наш рухавік апрацоўкі ECU непасрэдна ў вашу платформу. Ваш кліент загружает файл ECU на ваш сайт; вы адпраўляеце файл разам з рашэннямі, якія вам патрэбны; мы вяртаем выпраўлены файл — контрольная сума і RSA выпраўленыя аўтаматычна — без ручнога кіравання любым вэб-інтэрфейсам.

Базавы URL: https://www.davincideluxe.fr/api/v1/cloud

Выкарыстоўвае ваш існуючы рахунак DaVinci Deluxe · Cloud Edition. Падпішыцеся з дапамогай звычайнага разліку Stripe — ваш API ключ генеруецца аўтаматычна і з'явіцца ў вашым профілі.

Аўтэнтыфікацыя

Кожны запыт аўтэнтыфікуецца з дапамогай сакрэтнага API ключа, які адпраўляецца як токен Bearer. Сгенеруйце свой ключ у вашай панэлі кіравання на /profile#api пасля актывацыі плана API. Сыры ключ паказваецца адзін раз — захоўвайце яго бяспечна; мы захоўваем толькі хэш.

Authorization: Bearer dvc_live_xxxxxxxxxxxxxxxxxxxxxxxx

Хуткі старт

Падайце файл з рашэннямі, якія вам патрэбны, і URL для зваротнага выкліку. Вы атрымліваеце job_id адразу, а затым падпісаны вебхук, калі выпраўлены файл будзе гатовы.

# 1. Submit a job (multipart)
curl -X POST https://www.davincideluxe.fr/api/v1/cloud/jobs \
  -H "Authorization: Bearer dvc_live_xxxxx" \
  -F "file=@/path/to/original.bin" \
  -F "ecu_brand=Bosch" \
  -F "ecu_model=EDC17C64" \
  -F "fuel_type=diesel" \
  -F 'services=["DPF","EGR","ADBLUE","DTC"]' \
  -F 'tuning_options=["Stage 1"]' \
  -F "webhook_url=https://yourapp.com/hooks/davinci"

# → { "job_id": 1234, "status": "queued", "webhook_will_fire": true }

Канчатковыя кропкі

Падаць задачу

Content-Type: multipart/form-data. Адпраўце бінарны файл у file полі.

// 202 Accepted
{
  "job_id": 1234,
  "status": "queued",
  "status_url": "/api/v1/cloud/jobs/1234",
  "webhook_will_fire": true
}

Статус працы

Праверце прагрэсу, калі вы не выкарыстоўваеце webhook. Статус перамяшчаецца праз queued → processing → done (або error).

{
  "job_id": 1234,
  "status": "done",
  "result_url": "https://www.davincideluxe.fr/api/v1/cloud/jobs/1234/result"
}

Спампаваць вынік

Паток выпраўленага бінарнага файла (контрольная сума + RSA ўжо прымяняецца). Даступны адразу пасля status = done.

Спіс прац

Вяртае вашыя апошнія працы з статусам і часавымі меткамі.

Праверце пакрыццё (перш чым адправіць)

Вяртае жывое, рэальнае пакрыццё — дакладна якія ECU і службы апрацоўваюцца аўтаматычна зараз. Запытайце гэта перш чым загружаць так што вы адправіце толькі файлы, якія рухавік можа апрацаваць; усё, што за межамі гэтага спісу, адхіляецца (і ніколі не бярэцца платай). Два рэжымы:

// GET /api/v1/cloud/coverage?ecu=EDC17C50
{
  "ok": true,
  "ecu": "EDC17C50",
  "supported": true,
  "services": ["dpf", "egr", "adblue", "stage1", "stage2"]
}

Каталог DTC (коды памылак)

Вяртае каталог DTC (код памылкі) для ECU — той жа спіс кодаў памылак для кожнага ECU, паказаны ў настольным дадатку, цяпер даступны праграмна. Два рэжымы:

{
  "ok": true,
  "ecu": "MJ9DF",
  "matched": true,
  "results": [{
    "brand": "FCA",
    "ecu_model": "MJ9DF",
    "dtc_count": 90,
    "services": { "DPF": ["P040A-P040F", …], "EGR": […] }
  }]
}

Стан здароўя

Аўтэнтыфікаваны праверка актыўнасці. Таксама вяртае загалоўкі статусу вашай падпіскі.

Пакрытыя рашэнні

Две сям'і даступныя. Выдаленні / карэкцыі ідуць у services масіў; параметрызацыя прадукцыйнасці прэSETS ідуць у tuning_options масіў. Вы можаце аб'яднаць абодва ў адной задачы.

Антыпаляванне і карэкцыі — services

• DPF / FAP
• EGR
• AdBlue / SCR
• Выдаленне DTC
• Лямбда / O2
• Клапаны / Віхры
• NOx
• Старт і Стоп
• Фіксацыя гарачага старту
• Гатоўнасць / OBD

Параметрызацыя прадукцыйнасці — tuning_options

• Этап 1
• Этап 1+
• Этап 2
• Этап 3
• Эка Налада
• Папс і Бэнгс
• Папс і Бэнгс (пераключальныя)
• Кіраванне Запускам
• Хардкат / абмежавальнік абаротаў
• Канверсія E85

Падтрымліваемыя ECU & транспартныя сродкі

Жывая пакрыццё рухавіка — кожны брэнд, ECU і рашэнне

ECU hardware

• Bosch EDC15 / EDC16 / EDC17
• Bosch MED9 / MED17 / ME17 / MEDC17
• Bosch MG1 / MD1
• Continental · Siemens SID (201–807 EVO)
• Continental SIMOS 8 / 12 / 18
• Continental PCR 2.1 / PPD 1.x
• BMW MSD80–90 / MSV / MEVD17
• Delphi DCM3.x / 6.x / 7.x
• Delphi CRD2 / CRD3 / DDCR
• Denso
• Magneti Marelli MJD / IAW / 8GMK
• Valeo VD46.x / VD56.x / J34 / V34
• Visteon DCU102
• ZF (трансмісія)

Бренды аўтамабіляў

• Alfa Romeo
• Audi · VW · Seat · Skoda
• BMW · Mini
• Chery
• Chrysler · Dodge · Jeep
• Citroën · Peugeot · DS
• Dacia
• Deutz
• Ferrari
• Fiat · Lancia
• Ford
• Geely
• Great Wall
• Honda
• Hyundai · Kia
• Isuzu
• Iveco · CNH
• JAC
• Jaguar · Land Rover
• Kubota
• Mahindra
• MAN
• Maserati
• Maxus · LDV
• Mazda
• Mercedes-Benz · Smart
• Mitsubishi
• Nissan
• Opel · Chevrolet · Vauxhall
• Renault
• SsangYong
• Subaru
• Suzuki
• Toyota · Lexus
• Volvo

Новыя ECU дадаюцца пастаянна — глядзіце поўны спіс з магчымасцю пошуку. Калі вы не бачыце канкрэтны ECU, адправіце яго ў любым выпадку — калі мы не зможам яго апрацаваць, праца будзе адхілена з яснай прычынай і без платы.

Сумяшчальнасць і інтэграцыя

Гэта просты HTTPS REST API, таму ён працуе з любой платформай, мовай або хостынгам які можа зрабіць вэб-запыт і атрымаць webhook. Ніякіх SDK, ніякага спецыяльнага праграмнага забеспячэння, ніякай залежнасці з боку сервера з нашага боку.

Хостынг і серверы

• Любой Linux VPS / выдзелены сервер
• cPanel / Plesk / агульны хостынг
• Node.js хостынг
• Windows Server / IIS
• Хмара (AWS, GCP, Azure, OVH, Hetzner…)
• Безсерверны (Cloudflare Workers, Vercel, Lambda)

Платформы і CMS

• WordPress / WooCommerce (PHP)
• Joomla / Drupal / PrestaShop (PHP)
• Laravel / Symfony
• Node.js (Express, Next.js)
• Python (Django, Flask, FastAPI)
• Любой карыстальніцкі сайт з бэкендам

PHP прыкладзе (WordPress / cPanel)

<?php
// Submit a job from PHP (works in WordPress, Joomla, plain cPanel)
$ch = curl_init('https://www.davincideluxe.fr/api/v1/cloud/jobs');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer dvc_live_xxxxx'],
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => [
    'file'        => new CURLFile('/path/to/original.bin'),
    'ecu_brand'   => 'Bosch',
    'ecu_model'   => 'EDC17C64',
    'services'    => '["DPF","EGR","DTC"]',
    'webhook_url' => 'https://your-site.com/wp-json/davinci/v1/hook',
  ],
]);
$res = json_decode(curl_exec($ch), true);
// $res['job_id']

Праверка webhook у PHP

<?php
$payload = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_DVC_SIGNATURE'] ?? '';
$expected = 'sha256=' . hash_hmac('sha256', $payload, 'whsec_xxxxx');
if (!hash_equals($expected, $sig)) { http_response_code(400); exit; }
$evt = json_decode($payload, true);
// $evt['event'] === 'job.completed' -> download $evt['result_url'] with your API key

Прыклад на Python

import requests
r = requests.post(
  "https://www.davincideluxe.fr/api/v1/cloud/jobs",
  headers={"Authorization": "Bearer dvc_live_xxxxx"},
  files={"file": open("original.bin", "rb")},
  data={"ecu_brand": "Bosch", "ecu_model": "EDC17C64",
        "services": '["DPF","EGR","DTC"]',
        "webhook_url": "https://your-site.com/hooks/davinci"})
print(r.json()["job_id"])

Webhook (асінхронныя зваротныя выклікі)

Калі вы ўсталюеце webhook_url, мы POST JSON падзею ў момант, калі праца дасягае канчатковага стану — job.completed або job.failed. Дастаўка паўтараецца аўтаматычна (60с, 5хв, 30хв, да 4 спроб) на любы адказ, які не з 2xx.

POST https://yourapp.com/hooks/davinci
X-DvC-Event: job.completed
X-DvC-Signature: sha256=<hmac_hex>
X-DvC-Delivery-Attempt: 1

{
  "event": "job.completed",
  "job_id": 1234,
  "status": "done",
  "ecu_brand": "Bosch",
  "ecu_model": "EDC17C64",
  "services_applied": ["DPF","EGR","Stage 1"],
  "result_url": "https://www.davincideluxe.fr/api/v1/cloud/jobs/1234/result",
  "completed_at": "2026-06-20T10:30:00.000Z",
  "metadata": "your-reference"
}

Праверка подпісу

Кожны webhook падпісаны вашым пер-ключым сакрэт webhook (whsec_..., паказаны аднойчы, калі вы ствараеце ключ). Выкарыстоўвайце HMAC-SHA256 для сыравіннага цела запыту з гэтым сакрэтам і параўнайце з X-DvC-Signature загалоўкам.

// Node.js (Express) -- verify a DaVinci webhook
const crypto = require('crypto');

app.post('/hooks/davinci',
  express.raw({ type: 'application/json' }), (req, res) => {
    const sig = req.headers['x-dvc-signature'] || '';
    const expected = 'sha256=' + crypto
      .createHmac('sha256', process.env.DAVINCI_WEBHOOK_SECRET)
      .update(req.body)              // raw Buffer, not parsed JSON
      .digest('hex');
    if (sig !== expected) return res.sendStatus(400);

    const evt = JSON.parse(req.body.toString());
    // evt.event === 'job.completed' -> download evt.result_url with your API key
    res.sendStatus(200);
  });

Ліміты запытаў і памер файла

Стан вашай падпіскі вяртаецца на кожным аўтэнтыфікаваным выкліку, таму ваша інтэграцыя заўсёды ведае, што доступ актыўны:

X-DvC-Subscription-Status: active
X-DvC-Subscription-Period-End: 2026-07-20T00:00:00.000Z

Памылкі

Падтрымка

Дапамога па інтэграцыі, ключы пясочніцы або цэны за аб'ём: напішыце нам у WhatsApp. Мы звычайна адказваем у той жа дзень.

Усе апрацоўка выконваецца на файлах, якія вы упаўнаважаны змяняць.

Частыя пытанні

Як мне аўтэнтыфікавацца з Cloud Tuning API?

Кожны запыт выкарыстоўвае ключ API Bearer: адпраўце загаловак Authorization: Bearer dvc_live_. Вы самастойна ствараеце і адклікаеце ключы ў вашым профілі DaVinci Deluxe · Cloud Edition у наладках API.

Якія мовы праграмавання і платформы я магу выкарыстоўваць?

Любыя мовы або стэкі, якія могуць рабіць HTTPS-запыты, працуюць. Мы прапануем гатовыя прыклады на PHP (WordPress / cPanel) і Python, а REST API інтэгруецца з любой CMS, фреймворкам або хостынгавым правайдэрам.

Ці з'яўляецца Cloud Tuning API сінхронным або асінхронным?

Гэта асінхроннае. Вы адпраўляеце задачу, а затым або правяраеце статус задачы, або ўсталёўваеце URL вебхука, і мы POST-ім подпісаны зваротны выклік у момант, калі апрацаваны файл гатовы да загрузкі.

Якія ECU рашэнні і брэнды падтрымліваюцца?

Рашэнні для супрацьпаветранай забруджвальнасці і прадукцыйнасці, уключаючы DPF/FAP, EGR, AdBlue/SCR, выдаленне DTC, Lambda, MAF, Stage 1/2/3, Pops & Bangs і Hardcut ад Bosch, Continental, Siemens, Delphi, Marelli і іншых. Чэксум і RSA аўтаматычна выпраўляюцца; непадтрымліваемыя файлы адхіляюцца з яснай прычынай і ніколі не падлягаюць аплаце.

Якія ліміты запытаў API і максімальны памер файла?

API дазваляе да 60 запытаў у хвіліну і максімальны памер файла 50 МБ на задачу. Перасягненне ліміту вяртае HTTP 429 rate_limit_exceeded; паўторная спроба пасля кароткай затрымкі. Кожны план таксама мае штодзённы ліміт файлаў (Starter 100/день, Business 500/день, Enterprise неабмежаваны); перасягненне вяртае HTTP 429 daily_limit_reached.

Як мне праверыць, што вебхука зваротныя выклікі сапраўдныя?

Кожны вебхука падпісваецца з HMAC-SHA256 з выкарыстаннем вашага whsec_ сакрэта і дастаўляецца ў загалоўку X-DvC-Signature. Пералічыце подпіс над сырым целам запыту і параўнайце яго, каб пацвердзіць, што зваротны выклік сапраўды прыйшоў ад DaVinci Deluxe · Cloud Edition.