API Tuning Cloud

Mewnosod ein peiriant prosesu ECU yn uniongyrchol i mewn i'ch llwyfan. Mae eich cwsmer yn mynd i’r afael â ffeil ECU ar eich gwefan; anfonwch y ffeil yn ogystal â’r atebion y mae angen arnoch; byddwn yn dychwelyd y ffeil gywiro — gofrestr a RSA wedi'i sefydlu'n awtomatig — heb unrhyw driniaeth law yn y UI gwe.

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

Defnyddio eich cyfrif DaVinci Deluxe · Cloud Edition presennol. Cofrestrwch gyda’r siopa Stripe confensiynol — mae eich allwedd API yn cael ei generyddu'n awtomatig ac yn ymddangos yn eich proffil.

Awdurdodiad

Mae pob cais yn cael ei awdurdodi â allwedd API gyfrinachol a anfonir fel tokyn Bearer. Generwch eich allwedd yn eich dashfwrdd yn /profile#api ar ôl gweithredu cynllun API. Mae’r allwedd nas gellir ei gweld unwaith — ei chadw yn ddiogel; rydym yn cadw hash yn unig.

Authorization: Bearer dvc_live_xxxxxxxxxxxxxxxxxxxxxxxx

Dechrau Cyflym

Cyflwynwch ffeil gyda’r atebion sydd eu hangen arnoch a URL galw'n ôl. Mae gennych job_id yn dychwelyd yn syth, yna webhook wedi'i lofnodi pan fydd y ffeil gywiro'n barod.

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

Pwyntiau terfyn

Cyflwynwch swydd

Math Cynhwysydd: multipart/form-data. Anfonwch y binar mewn y file maes.

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

Statws y swydd

Arholwch am gynnydd os nad ydych yn defnyddio webhooks. Mae'r statws yn symud trwy queued → processing → done (neu error).

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

Lawrlwytho canlyniad

Mae'n llifo'r binafa cywiriad (cyfrif gwirion + RSA wedi'i gymhwyso eisoes). Ar gael unwaith status = done.

Rhestr swyddi

Mae'n dychwelyd eich swyddi diweddar gyda statws a phensiliau amser.

Gwirio y cwmpas (cyn i chi gyflwyno)

Mae'n dychwelyd y cwmpas byw, go iawn y peiriant — yn union pa ECUs a gwasanaethau sy'n cael eu prosesu'n awtomatig ar hyn o bryd. Gofynwch amdano cyn i chi uwchlwytho fel bod yn rhaid i chi gyflwyno ffeiliau y gall y peiriant eu trin; unrhyw beth y tu allan i'r rhestr hon sy'n cael ei wrthod (ac ni fydd ei godi). Dwy ddull:

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

Cataloq DTC (codau diffail)

Mae'n dychwelyd y cataloq DTC (cod diffail) ar gyfer ECU — yr un rhestr cod diffail per-ECU a ddangosir yn yr ap desg, nawr ar gael yn raglennu. Dwy ddull:

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

Iechyd

Gwiriad byw dilysedig. Mae'n dychwelyd hefyd benawdau statws eich tanysgrifiad.

Datrysiadau a gynhelir

Mae dwy deulu ar gael. Dileu / cywirdebau mynd i'r services aerys; addasiad perfformiad gosodwyd yn y tuning_options aerys. Gallwch gyfuno'r ddau mewn un swydd.

Anti-lchwyddo & cywirdebau — services

• DPF / FAP
• EGR
• AdBlue / SCR
• Diddymu DTC
• Lambda / O2
• Fflaps / Swirl
• NOx
• Dechrau & Stop
• Tybiaeth Cynnes
• Barodedd / OBD

Addasiad perfformiad — tuning_options

• Stage 1
• Stage 1+
• Stage 2
• Stage 3
• Eco Tune
• Pops & Bangs
• Pops & Bangs (newidiadwy)
• Rheolaeth Cychwyn
• Hardcut / cyfyngwr RPM
• Trawsnewid E85

ECUs & cerbydau a gynhelir

Gorchudd peiriant byw — pob brand, ECU a datrysiad

ECU caledwaith

• 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 (transmission)

Brandiau cerbydau

• 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

Mae ECUs newydd yn cael eu hychwanegu'n barhaus — gweler y rhestr gyflawn a chwistrelladwy. Os nad ydych yn gweld ECU penodol, ei gyflwyno o hyd — os na allwn ei brosesu, bydd y swydd yn cael ei gwrthod gyda rheswm clir a dim tâl.

Cydnawsedd & integreiddio

Mae'n API HTTPS REST syml, felly mae'n gweithio gyda phob llwyfan, iaith neu gynhelwr sy'n gallu gwneud cais gwe a derbyn webhook. Dim SDK, dim meddalwedd arbennig, dim dibyniaeth ar y server ar ein tudalen.

Cynhelwr & gweinyddion

• Unrhyw wasanaeth VPS Linux / gweinydd pwrpasol
• cPanel / Plesk / cynhelwr cydweithredol
• Cynhelwr Node.js
• Windows Server / IIS
• Cwmwl (AWS, GCP, Azure, OVH, Hetzner…)
• Serverless (Cloudflare Workers, Vercel, Lambda)

Llwyfannau & CMS

• WordPress / WooCommerce (PHP)
• Joomla / Drupal / PrestaShop (PHP)
• Laravel / Symfony
• Node.js (Express, Next.js)
• Python (Django, Flask, FastAPI)
• Unrhyw safle wedi'i deilwra gyda backend

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

Gwirio 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

Enghraifft 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 (callbackiau asynchrog)

Os gosodwch webhook_url, rydym yn POSTio digwyddiad JSON ar y funud y bydd y swydd yn cyrraedd cyflwr terfyn — job.completed neu job.failed. Mae'r danfoniad yn cael ei ail-geisio'n awtomatig (60s, 5min, 30min, hyd at 4 ymgais) ar unrhyw ymateb nad yw'n 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"
}

Gwirio'r llofnod

Mae pob webhook wedi'i lofnodi gyda'ch per-key dirgel webhook (whsec_..., a ddangosir unwaith pan fyddwch yn creu'r allwedd). Cyfrifwch HMAC-SHA256 o'r gorff cais crai gyda'r dirgelwch hwnnw a'i gymharu â'r X-DvC-Signature penawd.

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

Cyfyngiadau cyfradd & maint ffeil

Mae statws eich tanysgrifiad yn cael ei ddychwelyd ar bob galwad dilysedig felly mae eich integreiddiad bob amser yn gwybod bod mynediad yn fyw:

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

Gwallau

Cymorth

Cymorth integreiddio, allweddi sandbocs, neu brisiau cyfleoedd: anfonwch neges atom ar WhatsApp. Fel arfer, rydym yn ymateb ar y diwrnod un.

Mae pob broses yn cael ei pherfformio ar ffeiliau sydd gennych awdurdod i'w newid.

Cwestiynau a ofynnir yn aml

Sut ydw i'n dilysu gyda'r Cloud Tuning API?

Mae pob cais yn defnyddio allwedd API Bearer: anfonwch y penawdau Authorization: Bearer dvc_live_. Mae'n rhaid i chi greu a chanslo allweddi yn eich proffil DaVinci Deluxe · Cloud Edition dan osodiadau API.

Pa ieithoedd rhaglennu a llwyfannau y gallaf eu defnyddio?

Mae unrhyw iaith neu stacked sy'n gallu gwneud ceisiadau HTTPS yn gweithio. Rydym yn darparu enghreifftiau PHP (WordPress / cPanel) a Python parod, ac mae'r REST API yn ymddangos gyda unrhyw CMS, fframwaith neu ddarparwr hostio.

A yw'r Cloud Tuning API yn gyflawn symudol neu'n gyflym?

Mae'n gyflym. Mae'n rhaid i chi gyflwyno swydd, yna naill ai edrych ar bwynt statws y swydd neu osod URL webhook a byddwn yn POSTio galwad wedi'i llofnodi ar unwaith pan fydd y ffeil brosesedig yn barod i'w lawrlwytho.

Pa atebion ECU a brandiau sy'n cael eu cefnogi?

Atebion gwrth-bollution a pherfformiad gan gynnwys DPF/FAP, EGR, AdBlue/SCR, dileu DTC, Lambda, MAF, Stage 1/2/3, Pops & Bangs a Hardcut ymhlith Bosch, Continental, Siemens, Delphi, Marelli ac eraill. Mae checksum a RSA yn cael eu cywiro'n awtomatig; mae ffeiliau heb eu cefnogi yn cael eu gwrthod gyda rheswm clir ac ni fyddant byth yn cael eu codi tâl.

Beth yw'r terfynau cyflymder API a'r maint ffeil mwyaf?

Mae'r API yn caniatáu hyd at 60 ceisiadau y funud a maint ffeil mwyaf o 50 MB y swydd. Mae gorlwytho'r terfyn cyflymder yn dychwelyd HTTP 429 rate_limit_exceeded; ceisiwch eto ar ôl oedi byr. Mae gan bob cynllun hefyd derfyn ffeil ddyddiol (Starter 100/y dydd, Busnes 500/y dydd, Menter ddim cyfyngiadau); mae gorlwytho yn dychwelyd HTTP 429 daily_limit_reached.

Sut ydw i’n gwirio bod galwadau webhook yn ddilys?

Mae pob webhook wedi'i lofnodi gyda HMAC-SHA256 gan ddefnyddio eich cyfrinach whsec_ a'i dyrchafu yn y penawd X-DvC-Signature. Ail-fyw'r llofnod dros y corff cais crai a'i gymharu i gadarnhau bod y galwad yn dalodd yn wirioneddol o DaVinci Deluxe · Cloud Edition.