Cloud Tuning 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 }

Краища

Изпратете задача

Съдържание-тип: multipart/form-data. Изпратете бинарния файл в file полето.

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

Статус на работата

Проверявайте напредъка, ако не използвате уебхукове. Статусът преминава през queued → processing → done (или error).

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

Изтеглете резултата

Поток на коригирания бинарен файл (checksum + 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 масив; производителен тунинг предустановките влизат в tuning_options масив. Можете да комбинирате и двете в една работа.

Антизамърсяване и корекции — services

• DPF / FAP
• EGR
• AdBlue / SCR
• Премахване на DTC
• Лямбда / O2
• Клапи / Вихрови
• NOx
• Старт и Стоп
• Поправка на горещ старт
• Готовност / OBD

Производителен тунинг — tuning_options

• Етап 1
• Етап 1+
• Етап 2
• Етап 3
• Еко тунинг
• Попове и Ударове
• Попове и Ударове (с превключвател)
• Контрол на стартиране
• Hardcut / ограничител на RPM
• Конверсия E85

Поддържани ECU и превозни средства

Живо покритие на двигателя — всяка марка, ECU и решение

ECU хардуер

• 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, така че работи с всяка платформа, език или хостинг които могат да направят уеб заявка и да получат уебхук. Няма 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']

Проверка на уебхука в 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_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"
}

Проверка на подписа

Всеки уебхук е подписан с вашия ключ за уебхук секрет (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?

Всяка заявка използва Bearer API ключ: изпратете заглавието Authorization: Bearer dvc_live_. Вие сами създавате и оттегляте ключове в профила си на DaVinci Deluxe · Cloud Edition под настройките на API.

Кои програмни езици и платформи мога да използвам?

Всеки език или стек, който може да прави HTTPS заявки, работи. Предоставяме готови примери на PHP (WordPress / cPanel) и Python, а REST API се интегрира с всяка CMS, фреймуърк или хостинг доставчик.

Cloud Tuning API е синхронен или асинхронен?

Той е асинхронен. Подавате задача, след което или проверявате статуса на задачата, или задавате URL за webhook и ние POST-им подписан callback в момента, в който обработеният файл е готов за изтегляне.

Кои 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 MB на задача. Превишаването на лимита за натоварване връща HTTP 429 rate_limit_exceeded; опитайте отново след кратко забавяне. Всеки план също има дневен лимит на файловете (Starter 100/ден, Business 500/ден, Enterprise неограничен); превишаването му връща HTTP 429 daily_limit_reached.

Как да проверя дали webhook callback-овете са истински?

Всеки webhook е подписан с HMAC-SHA256, използвайки вашия whsec_ таен ключ и се доставя в заглавието X-DvC-Signature. Пресметнете отново подписа върху оригиналното тяло на заявката и го сравнете, за да потвърдите, че callback-ът наистина е дошъл от DaVinci Deluxe · Cloud Edition.