API de Tuning al núvol

Integra el nostre motor de processament d'ECU directament a la teva plataforma. El teu client puja un fitxer d'ECU al teu lloc; tu envies el fitxer més les solucions que vols; nosaltres tornem el fitxer corregit — checksum i RSA fixats automàticament — sense manipulació manual de cap interfície web.

URL base: https://www.davincideluxe.fr/api/v1/cloud

Utilitza el teu compte existent de DaVinci Deluxe · Cloud Edition. Subscriu-te amb el pagament normal de Stripe — la teva clau d'API es genera automàticament i apareix al teu perfil.

Autenticació

Cada sol·licitud està autenticada amb una clau d'API secreta enviada com a token Bearer. Genera la teva clau al teu tauler de control a /profile#api després d'activar un pla d'API. La clau en brut es mostra una vegada — emmagatzema-la de manera segura; només mantenim un hash.

Authorization: Bearer dvc_live_xxxxxxxxxxxxxxxxxxxxxxxx

Inici ràpid

Envia un fitxer amb les solucions que vols i una URL de callback. Rebràs un job_id immediatament, després un webhook signat quan el fitxer corregit estigui llest.

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

Punts finals

Envia una feina

Content-Type: multipart/form-data. Envia el binari al file camp.

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

Estat de la feina

Consulta per a l'avanç si no esteu utilitzant webhooks. L'estat avança a través de queued → processing → done (o error).

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

Descarregar resultat

Transmet el binari corregit (checksum + RSA ja aplicat). Disponible un cop status = done.

Llista de feines

Retorna les vostres feines recents amb estat i marques de temps.

Comproveu la cobertura (abans de presentar)

Retorna la cobertura en viu, real del motor — exactament quines ECUs i serveis s'estan processant automàticament ara mateix. Consulteu-ho abans de pujar així només presenteu fitxers que el motor pot gestionar; qualsevol cosa fora d'aquesta llista és rebutjada (i mai cobrada). Dos modes:

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

Catàleg de DTC (còdigs d'error)

Retorna el catàleg de DTC (còdigs d'error) per a una ECU — la mateixa llista de codis d'error per ECU mostrada a l'aplicació d'escriptori, ara disponible programàticament. Dos modes:

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

Salut

Comprovació d'autenticitat de l'activitat. També retorna els encapçalaments de l'estat de la vostra subscripció.

Solucions cobertes

Hi ha dues famílies disponibles. Esborraments / correccions van al services array; remapatge de rendiment els presets van al tuning_options array. Podeu combinar ambdós en un sol treball.

Antipol·lució i correccions — services

• DPF / FAP
• EGR
• AdBlue / SCR
• Eliminació de DTC
• Lambda / O2
• Flaps / Swirl
• NOx
• Inici i Aturada
• Solució d'Inici Calent
• Preparació / OBD

Remapatge de rendiment — tuning_options

• Stage 1
• Stage 1+
• Stage 2
• Stage 3
• Eco Tune
• Pops & Bangs
• Pops & Bangs (intercanviable)
• Control de Llançament
• Limitador de Hardcut / RPM
• Conversió E85

ECUs i vehicles compatibles

Cobertura en viu del motor — cada marca, ECU i solució

maquinari 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 (transmissió)

Marques de vehicles

• 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

Nous ECUs s'afegeixen contínuament — vegeu la llista completa cercable. Si no veieu un ECU específic, envieu-lo igualment — si no podem processar-lo, la feina es rebutja amb un motiu clar i sense càrrec.

Compatibilitat i integració

És una API REST HTTPS senzilla, així que funciona amb qualsevol plataforma, llenguatge o hosting que pugui fer una sol·licitud web i rebre un webhook. Sense SDK, sense programari especial, sense dependència del servidor per la nostra banda.

Hosting i servidors

• Qualsevol VPS / servidor dedicat Linux
• cPanel / Plesk / hosting compartit
• Hosting Node.js
• Windows Server / IIS
• Núvol (AWS, GCP, Azure, OVH, Hetzner…)
• Sense servidor (Cloudflare Workers, Vercel, Lambda)

Plataformes i CMS

• WordPress / WooCommerce (PHP)
• Joomla / Drupal / PrestaShop (PHP)
• Laravel / Symfony
• Node.js (Express, Next.js)
• Python (Django, Flask, FastAPI)
• Qualsevol lloc personalitzat amb un backend

exemple 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']

Verificació de 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

Exemple 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 (callbacks asíncrons)

Si configureu webhook_url, enviem un esdeveniment JSON en el moment que la feina arriba a un estat terminal — job.completed o job.failed. La entrega es torna a intentar automàticament (60s, 5min, 30min, fins a 4 intents) en qualsevol resposta no-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"
}

Verificant la signatura

Cada webhook està signat amb la vostra clau per clau secret webhook (whsec_..., mostrat una vegada quan crees la clau). Calcula un HMAC-SHA256 del cos de la sol·licitud en brut amb aquest secret i compara-ho amb el X-DvC-Signature capçalera.

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

Límits de taxa i mida de fitxer

L'estat de la teva subscripció es retorna en cada trucada autenticada, així que la teva integració sempre sap que l'accés és actiu:

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

Errors

Suport

Ajuda d'integració, claus de sandbox o preus per volum: envia'ns un missatge per WhatsApp. Normalment responem el mateix dia.

Tots els processaments es realitzen en fitxers que estàs autoritzat a modificar.

Preguntes freqüents

Com m'autentico amb l'API de Cloud Tuning?

Cada sol·licitud utilitza una clau API Bearer: envia l'encapçalament Authorization: Bearer dvc_live_. Tu mateix crees i revokes les claus al teu perfil de DaVinci Deluxe · Cloud Edition sota la configuració de l'API.

Quines llengües de programació i plataformes puc utilitzar?

Qualsevol llengua o stack que pugui fer sol·licituds HTTPS funciona. Proporcionem exemples de PHP (WordPress / cPanel) i Python llestos, i l'API REST s'integra amb qualsevol CMS, marc o proveïdor d'allotjament.

L'API de Cloud Tuning és sincrònica o asincrònica?

És asincrònica. En submits una feina, després pots consultar l'endpoint de l'estat de la feina o establir una URL de webhook i nosaltres enviem un callback signat en el moment en què el fitxer processat està llest per descarregar.

Quines solucions i marques d'ECU són compatibles?

Solucions anti-contaminació i de rendiment que inclouen DPF/FAP, EGR, AdBlue/SCR, eliminació de DTC, Lambda, MAF, Stage 1/2/3, Pops & Bangs i Hardcut a través de Bosch, Continental, Siemens, Delphi, Marelli i més. El checksum i RSA es corregeixen automàticament; els fitxers no compatibles es rebutgen amb un motiu clar i mai es cobren.

Quins són els límits de taxa de l'API i la mida màxima del fitxer?

L'API permet fins a 60 sol·licituds per minut i una mida màxima de fitxer de 50 MB per feina. Superar el límit de burst retorna HTTP 429 rate_limit_exceeded; torna a intentar-ho després d'un breu retard. Cada pla també té un límit diari de fitxers (Starter 100/dia, Business 500/dia, Enterprise il·limitat); superar-lo retorna HTTP 429 daily_limit_reached.

Com puc verificar que els callbacks de webhook són genuïns?

Cada webhook està signat amb HMAC-SHA256 utilitzant el teu secret whsec_ i es lliura en l'encapçalament X-DvC-Signature. Recalcula la signatura sobre el cos de la sol·licitud en brut i compara-la per confirmar que el callback realment prové de DaVinci Deluxe · Cloud Edition.