Cloud Tuning API

Integrovat náš motor pro zpracování ECU přímo do vaší platformy. Váš zákazník nahraje soubor ECU na vašem webu; vy odešlete soubor plus řešení, která chcete; my vrátíme opravený soubor — checksum a RSA opraveny automaticky — bez manuálního zpracování jakéhokoli webového rozhraní.

Základní URL: https://www.davincideluxe.fr/api/v1/cloud

Používá váš stávající účet DaVinci Deluxe · Cloud Edition. Přihlaste se pomocí běžného Stripe checkoutu — váš API klíč je generován automaticky a zobrazuje se ve vašem profilu.

Ověření

Každý požadavek je ověřen tajným API klíčem odeslaným jako Bearer token. Vygenerujte si svůj klíč ve svém řídicím panelu na /profile#api po aktivaci plánu API. Původní klíč je zobrazen jednou — uložte ho bezpečně; uchováváme pouze hash.

Authorization: Bearer dvc_live_xxxxxxxxxxxxxxxxxxxxxxxx

Rychlý start

Odešlete soubor se řešeními, která chcete, a URL pro zpětné volání. Okamžitě obdržíte job_id , poté podepsaný webhook, když je opravený soubor připraven.

# 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 }

Endpointy

Odeslat úkol

Content-Type: multipart/form-data. Odešlete binární data v file poli.

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

Stav úlohy

Dotazujte na pokrok, pokud nepoužíváte webhooks. Stav se mění přes queued → processing → done (nebo error).

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

Stáhnout výsledek

Streamuje opravený binární soubor (checksum + RSA již aplikováno). K dispozici jakmile status = done.

Seznam úloh

Vrací vaše nedávné úlohy se stavem a časovými razítky.

Zkontrolujte pokrytí (před odesláním)

Vrací motoru živé, skutečné pokrytí — přesně které ECU a služby jsou právě teď automaticky zpracovávány. Dotazujte to před nahráním tak, abyste odeslali pouze soubory, které motor může zpracovat; cokoliv mimo tento seznam je odmítnuto (a nikdy není účtováno). Dva režimy:

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

Katalog DTC (chyby kódů)

Vrací katalog DTC (kódů chyb) pro ECU — stejný seznam kódů chyb pro každou ECU zobrazený v desktopové aplikaci, nyní dostupný programově. Dva režimy:

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

Zdraví

Ověřená kontrola živosti. Také vrací hlavičky stavu vaší předplatné.

Pokryté řešení

Jsou k dispozici dvě rodiny. Odstranění / opravy jdou do services pole; výkonové ladění předvolby jdou do tuning_options pole. Můžete kombinovat obě v jedné zakázce.

Antipollution & opravy — services

• DPF / FAP
• EGR
• AdBlue / SCR
• Odstranění DTC
• Lambda / O2
• Klapky / víření
• NOx
• Start & Stop
• Oprava horkého startu
• Připravenost / OBD

Výkonové ladění — tuning_options

• Stage 1
• Stage 1+
• Stage 2
• Stage 3
• Eco Tune
• Pops & Bangs
• Pops & Bangs (přepínatelné)
• Kontrola startu
• Hardcut / omezovač otáček
• E85 konverze

Podporované ECU a vozidla

Živé pokrytí motoru — každá značka, ECU a řešení

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 (převodovka)

Značky vozidel

• Alfa Romeo
• Audi · VW · Seat · Škoda
• 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

Nové ECU jsou přidávány neustále — podívejte se na úplný vyhledávatelný seznam. Pokud nevidíte konkrétní ECU, zašlete ji přesto — pokud ji nemůžeme zpracovat, úkol je zamítnut s jasným důvodem a bez poplatku.

Kompatibilita & integrace

Je to obyčejné HTTPS REST API, takže funguje s jakoukoli platformou, jazykem nebo hostingem který může provádět webové požadavky a přijímat webhook. Žádné SDK, žádný speciální software, žádná závislost na serverové straně z naší strany.

Hosting & servery

• Jakýkoli Linux VPS / dedikovaný server
• cPanel / Plesk / sdílený hosting
• Hosting Node.js
• Windows Server / IIS
• Cloud (AWS, GCP, Azure, OVH, Hetzner…)
• Serverless (Cloudflare Workers, Vercel, Lambda)

Platformy & CMS

• WordPress / WooCommerce (PHP)
• Joomla / Drupal / PrestaShop (PHP)
• Laravel / Symfony
• Node.js (Express, Next.js)
• Python (Django, Flask, FastAPI)
• Jakákoli vlastní stránka s backendem

PHP příkladu (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']

Ověření webhooku v 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

Příklad v Pythonu

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"])

Webhooky (asynchronní zpětné volání)

Pokud nastavíte webhook_url, POSTujeme JSON událost ve chvíli, kdy úkol dosáhne terminálního stavu — job.completed nebo job.failed. Doručení se automaticky opakuje (60s, 5min, 30min, až 4 pokusy) na jakoukoli odpověď, která není 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"
}

Ověření podpisu

Každý webhook je podepsán vaším klíčem per-key webhook tajný klíč (whsec_..., zobrazeno jednou při vytvoření klíče). Vypočítejte HMAC-SHA256 z raw request body s tímto tajným klíčem a porovnejte to s X-DvC-Signature hlavičkou.

// 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);
  });

Limity a velikost souboru

Stav vašeho předplatného je vrácen při každém autentizovaném volání, takže vaše integrace vždy ví, že přístup je aktivní:

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

Chyby

Podpora

Pomoc s integrací, sandboxové klíče nebo cenové nabídky na objem: kontaktujte nás na WhatsApp. Obvykle odpovídáme ve stejný den.

Veškeré zpracování probíhá na souborech, které máte oprávnění upravovat.

Často kladené otázky

Jak se autentizuji pomocí Cloud Tuning API?

Každý požadavek používá Bearer API klíč: odešlete hlavičku Authorization: Bearer dvc_live_. Klíče vytváříte a odvoláváte sami ve svém profilu DaVinci Deluxe · Cloud Edition v nastavení API.

Jaké programovací jazyky a platformy mohu použít?

Jakýkoli jazyk nebo stack, který může provádět HTTPS požadavky, funguje. Poskytujeme připravené příklady v PHP (WordPress / cPanel) a Pythonu, a REST API se integruje s jakýmkoli CMS, frameworkem nebo poskytovatelem hostingu.

Je Cloud Tuning API synchronní nebo asynchronní?

Je to asynchronní. Odesíláte úkol, poté buď dotazujete endpoint stavu úkolu, nebo nastavíte webhook URL a my POSTujeme podepsaný callback v okamžiku, kdy je zpracovaný soubor připraven k stažení.

Jaká řešení a značky ECU jsou podporovány?

Řešení pro ochranu životního prostředí a výkon včetně DPF/FAP, EGR, AdBlue/SCR, odstranění DTC, Lambda, MAF, Stage 1/2/3, Pops & Bangs a Hardcut napříč Bosch, Continental, Siemens, Delphi, Marelli a dalšími. Kontrolní součet a RSA jsou automaticky opraveny; nepodporované soubory jsou odmítnuty s jasným důvodem a nikdy nejsou zpoplatněny.

Jaké jsou limity API a maximální velikost souboru?

API umožňuje až 60 požadavků za minutu a maximální velikost souboru 50 MB na úkol. Překročení limitu burst vrátí HTTP 429 rate_limit_exceeded; zkuste to znovu po krátké prodlevě. Každý plán má také denní limit souborů (Starter 100/den, Business 500/den, Enterprise neomezeně); překročení tohoto limitu vrátí HTTP 429 daily_limit_reached.

Jak ověřím, že webhook callbacky jsou skutečné?

Každý webhook je podepsán pomocí HMAC-SHA256 s vaším tajemstvím whsec_ a doručen v hlavičce X-DvC-Signature. Znovu vypočítejte podpis nad surovým tělem požadavku a porovnejte ho, abyste potvrdili, že callback skutečně pochází z DaVinci Deluxe · Cloud Edition.