API di Tuning in Cloud

Integra u nostru mutore di prucedura ECU direttamente in a vostra piattaforma. U vostru cliente carica un schedariu ECU nantu à u vostru situ; voi mandate u schedariu più e suluzioni chì vulete; noi riturnemu u schedariu currettu — checksum è RSA fissi automaticamente — senza manipulazione manuale di alcuna interfaccia web.

URL di basa: https://www.davincideluxe.fr/api/v1/cloud

Utilize u vostru contu esistente DaVinci Deluxe · Cloud Edition. Iscriviti cù u checkout normale di Stripe — a vostra chjave API hè generata automaticamente è appare in u vostru prufilu.

Autenticazione

Ogni richiesta hè autenticata cù una chjave API secreta mandata cum'è un token Bearer. Genera a vostra chjave in u vostru dashboard à /profile#api dopu avè attivatu un pianu API. A chjave grezza hè mostrata una volta — almacenate in modu sicuru; noi manteniamu solu un hash.

Authorization: Bearer dvc_live_xxxxxxxxxxxxxxxxxxxxxxxx

Iniziu veloce

Sottumettite un schedariu cù e suluzioni chì vulete è un URL di callback. Riceverete un job_id immediatamente, poi un webhook firmatu quandu u schedariu currettu hè prontu.

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

Punti di accessu

Sottumette un travagliu

Content-Type: multipart/form-data. Mandate u binariu in u file campu.

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

Statu di u travagliu

Fate un poll per u prugressu se ùn utilizate micca webhooks. U statu si sposta trà queued → processing → done (o error).

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

Scaricate u risultatu

Flussi u binariu currettu (checksum + RSA già applicatu). Dispunibule una volta status = done.

Elenca i travagli

Restituisce i vostri travagli recenti cù statu è timestamp.

Verificate a copertura (prima di inviare)

Restituisce a copertura attuale è reale di u mutore — esattamente quali ECUs è servizii sò trattati automaticamente in questu mumentu. Interrogatela prima di caricare in modu chì inviate solu i file chì u mutore pò gestisce; qualsiasi cosa fora di sta lista hè rifiutata (è mai addebitata). Dui modi:

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

Catalogu DTC (codici di guasto)

Restituisce u catalogu DTC (codici di guasto) per un ECU — a listessa lista di codici di guasto per ECU mostrata in l'app desktop, avà dispunibile programmaticamente. Dui modi:

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

Salute

Verifica di vivacità autenticata. Ritorna ancu i vostri intestazioni di statutu di abbonamentu.

Soluzioni coperte

Due famiglie sò dispunibili. Eliminazioni / correzioni andate in u services array; tuning di prestazione i presets andanu in u tuning_options array. Pudete cumminà i dui in un solu travagliu.

Anti-polluzione & correzioni — services

• DPF / FAP
• EGR
• AdBlue / SCR
• Rimozione DTC
• Lambda / O2
• Flaps / Swirl
• NOx
• Start & Stop
• Correzione di Start Caldu
• Prontezza / OBD

Tuning di prestazione — tuning_options

• Stage 1
• Stage 1+
• Stage 2
• Stage 3
• Eco Tune
• Pops & Bangs
• Pops & Bangs (switchable)
• Controllu di Lanciu
• Hardcut / limitatore di RPM
• Cunversione E85

ECUs è veiculi supportati

Copertura di motore in diretta — ogni marca, ECU è suluzione

Hardware 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 (trasmissione)

Marche di veiculi

• 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

I novi ECU sò aghjunti continuamente — vede u elencu cumpletu ricercabile. Se ùn vede micca un ECU specificu, inviatelu in ogni casu — se ùn pudemu micca trattà, u travagliu hè rifiutatu cun un mutivu chjaru è senza spese.

Compatibilità è integrazione

Hè una API REST HTTPS semplice, dunque funziona cù qualsiasi piattaforma, lingua o hosting chì pò fà una richiesta web è riceve un webhook. Nisuna SDK, nisun software speciale, nisuna dipendenza da u nostru latu.

Hosting è servers

• Qualunque VPS Linux / server dedicatu
• cPanel / Plesk / hosting spartutu
• Hosting Node.js
• Windows Server / IIS
• Cloud (AWS, GCP, Azure, OVH, Hetzner…)
• Serverless (Cloudflare Workers, Vercel, Lambda)

Piattaforme è CMS

• WordPress / WooCommerce (PHP)
• Joomla / Drupal / PrestaShop (PHP)
• Laravel / Symfony
• Node.js (Express, Next.js)
• Python (Django, Flask, FastAPI)
• Qualunque situ personalizatu cù un backend

PHP esempiu (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']

Verificazione di 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

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

Webhooks (callback asincroni)

Se impostate webhook_url, noi POST un avvenimentu JSON appena u travagliu ghjunghje à un statu terminale — job.completed o job.failed. A consegna hè ripetuta automaticamente (60s, 5min, 30min, finu à 4 tentativi) nantu à qualsiasi risposta non 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"
}

Verificazione di a firma

Ogni webhook hè firmatu cù a vostra chjave per secreti webhook (whsec_..., mostratu una volta quandu crei a chjave). Calculeghja un HMAC-SHA256 di u corpu di richiesta raw cù quellu secreti è paragunate lu à u X-DvC-Signature header.

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

Limiti di tariffa & dimensione di file

U statu di a vostra abbonamentu hè restituitu à ogni chjamata autenticata, cusì a vostra integrazione sapi sempre chì l'accessu hè attivu:

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

Errori

Supportu

Aiutu di integrazione, chjave sandbox, o prezzi di volume: messagiateci nantu à WhatsApp. Di solitu rispondiamu u stessu ghjornu.

Tuttu u prucessu hè realizatu nantu à i fugliali chì site autorizatu à mudificà.

Dumande frequente

Cumu autenticà cù l'API Cloud Tuning?

Ogni richiesta utilizza una chjave API Bearer: manda l'intestazione Authorization: Bearer dvc_live_. Crei è revocheghji e chjave da voi stessi in u vostru profilu DaVinci Deluxe · Cloud Edition sottu à e impostazioni API.

Quali linguaghji di prugrammazione è piattaforme possu utilizà?

Qualunque lingua o stack chì pò fà richieste HTTPS funziona. Offremu esempi pronti in PHP (WordPress / cPanel) è Python, è l'API REST si integra cù qualsiasi CMS, framework o fornitore di hosting.

L'API Cloud Tuning hè sincrona o asincrona?

Hè asincrona. Presentate un travagliu, poi o interrogate l'endpoint di stato di travagliu o impostate un URL webhook è noi POSTemu un callback firmatu appena u fugliale prucessatu hè prontu à scaricà.

Quali soluzioni è marche ECU sò supportate?

Soluzioni anti-polluzione è di prestazione chì includenu DPF/FAP, EGR, AdBlue/SCR, rimozione di DTC, Lambda, MAF, Stage 1/2/3, Pops & Bangs è Hardcut trà Bosch, Continental, Siemens, Delphi, Marelli è più. A checksum è l'RSA sò corretti automaticamente; i fugliali micca supportati sò rifiutati cù una ragione chjara è mai addebitati.

Quali sò i limiti di tariffa API è a dimensione massima di u fugliale?

L'API permette finu à 60 richieste per minuta è una dimensione massima di fugliale di 50 MB per travagliu. Superendu u limite di esplosione restituisce HTTP 429 rate_limit_exceeded; riprovate dopu un breve ritardu. Ogni pianu hà ancu un limite di fugliali ghjurnali (Starter 100/giornu, Business 500/giornu, Enterprise illimitatu); superendu restituisce HTTP 429 daily_limit_reached.

Cumu verificà chì i callback webhook sò genuini?

Ogni webhook hè firmatu cù HMAC-SHA256 utilizendu u vostru segretu whsec_ è hè consegnatu in l'intestazione X-DvC-Signature. Ricumpunite a firma nantu à u corpu di richiesta grezza è cumparatela per cunfirmà chì u callback hè veramente venutu da DaVinci Deluxe · Cloud Edition.