Cloud Tuning API

ECU emal mühərrikimizi birbaşa platformanıza inteqrasiya edin. Müştəriniz saytınıza ECU faylı yükləyir; siz faylı və istədiyiniz həlləri göndərirsiniz; biz düzəldilmiş faylı geri qaytarırıq — checksum və RSA avtomatik düzəldilir — hər hansı bir veb UI-nin əl ilə idarə olunması olmadan.

Əsas URL: https://www.davincideluxe.fr/api/v1/cloud

Mövcud DaVinci Deluxe · Cloud Edition hesabınızı istifadə edir. Normal Stripe ödənişi ilə abunə olun — API açarınız avtomatik yaradılır və profilinizdə görünür.

Autentifikasiya

Hər bir tələb gizli API açarı ilə Bearer token olaraq autentifikasiya edilir. Açarınızı panelinizdə yaradın /profile#api API planını aktivləşdirdikdən sonra. Xam açar bir dəfə göstərilir — onu təhlükəsiz saxlayın; biz yalnız bir hash saxlayırıq. Açarlar sizin hesabınıza məhdudlaşdırılır. Bir neçə açar yaradın (staging / production) və istənilənini paneldən dərhal ləğv edin. Ləğv edilmiş və ya dayandırılmış açar

Authorization: Bearer dvc_live_xxxxxxxxxxxxxxxxxxxxxxxx

Tez başlama

İstədiyiniz həlləri və bir geri çağırma URL-sini olan bir fayl göndərin. Siz dərhal job_id alırsınız, sonra düzəldilmiş fayl hazır olduqda imzalanmış vebhook alırsınız.

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

Son nöqtələr

Bir iş təqdim edin

Məzmun Tipi: multipart/form-data. İkiliyi file sahəsində göndərin.

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

İşin vəziyyəti

Webhooks istifadə etmirsinizsə, irəliləyiş üçün sorğu edin. Vəziyyət queued → processing → done (və ya error).

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

Nəticəni yüklə

Düzəldilmiş ikili axını (checksum + RSA artıq tətbiq olunmuş) axıdılır. status = done.

İşləri siyahıya al

Son zamanlar etdiyiniz işləri vəziyyət və zaman damgaları ilə qaytarır.

Örtüyü yoxlayın (t təqdim etməzdən əvvəl)

Mühərrikin canlı, real örtüyü — dəqiq hansı ECU-ların və xidmətlərin hazırda avtomatik işlənildiyini göstərir. Yükləməzdən əvvəl bunu soruşun ki, yalnız mühərrikin idarə edə biləcəyi faylları təqdim edəsiniz; bu siyahıdan kənar olan hər şey qəbul edilmir (və heç vaxt ödənilmir). İki rejim: Sorğu

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

DTC kataloqu (xəta kodları)

DTC (xəta kodu) kataloqunu qaytarır bir ECU üçün — masaüstü tətbiqində göstərilən eyni ECU üzrə xəta kodları siyahısı, indi proqram vasitəsilə mövcuddur. İki rejim: Sorğu

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

Sağlamlıq

Təsdiqlənmiş canlılıq yoxlaması. Həmçinin abunə statusu başlıqlarını qaytarır.

Əhatə olunan həllər

İki ailə mövcuddur. Silinmələr / düzəlişlər daxil olur services massivi; performans tuning presetlər daxil olur tuning_options massivi. Hər ikisini tək bir işdə birləşdirə bilərsiniz.

Anti-çirklənmə & düzəlişlər — services

• DPF / FAP
• EGR
• AdBlue / SCR
• DTC silinməsi
• Lambda / O2
• Qapaqlar / Dönmə
• NOx
• Başlama & Dayanma
• İsti Başlama düzəlişi
• Hazırlıq / OBD

Performans tuning — tuning_options

• Stage 1
• Stage 1+
• Stage 2
• Stage 3
• Ekoloji Tune
• Pops & Bangs
• Pops & Bangs (döndürülə bilən)
• Başlatma İdarəsi
• Sərt kəsim / RPM məhdudlaşdırıcı
• E85 konversiyası

Dəstəklənən ECUs & nəqliyyat vasitələri

Canlı mühərrik əhatəsi — hər marka, ECU və həll

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

Nəqliyyat vasitəsi markaları

• 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

Yeni ECU-lar davamlı olaraq əlavə olunur — baxın tam axtarış edilə bilən siyahıya. Əgər spesifik bir ECU görmürsünüzsə, onu göndərin — əgər işləyə bilməsək, iş aydın səbəblə və ödənişsiz olaraq rədd edilir.

Uyğunluq & inteqrasiya

Bu, sadə HTTPS REST API-dir, buna görə də istənilən platforma, dil və ya hosting ilə işləyir ki, veb sorğu edə bilər və webhook ala bilər. SDK yoxdur, xüsusi proqram yoxdur, bizim tərəfimizdən server tərəfində asılılıq yoxdur.

Hosting & serverlər

• Hər hansı bir Linux VPS / xüsusi server
• cPanel / Plesk / paylaşılmış hosting
• Node.js hosting
• Windows Server / IIS
• Cloud (AWS, GCP, Azure, OVH, Hetzner…)
• Serverless (Cloudflare Workers, Vercel, Lambda)

Platformalar & CMS

• WordPress / WooCommerce (PHP)
• Joomla / Drupal / PrestaShop (PHP)
• Laravel / Symfony
• Node.js (Express, Next.js)
• Python (Django, Flask, FastAPI)
• Hər hansı bir backend ilə xüsusi sayt

PHP nümunəsində bir neçə sətir (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 webhook təsdiqi

<?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 nümunəsi

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 (asinxron geri çağırmalar)

Əgər siz webhook_urlqoysanız, biz iş terminal vəziyyətinə çatdıqda JSON hadisəsini POST edirik — job.completed və ya job.failed. Çatdırılma avtomatik olaraq təkrar edilir (60s, 5 dəq, 30 dəq, 4 cəhddən çox olmayaraq) hər hansı bir 2xx-dən fərqli cavabda.

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

İmzayı təsdiqləmək

Hər webhook sizin per-key ilə imzalanır webhook gizli (whsec_..., açarı yaratdığınız zaman bir dəfə göstərilir). HMAC-SHA256 hesablayın xam tələb bədəni bu gizli ilə və onu X-DvC-Signature başlıqla müqayisə edin.

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

Dərəcə limitləri & fayl ölçüsü

Abunəlik vəziyyətiniz hər təsdiqlənmiş çağırışda geri qaytarılır, beləliklə inteqrasiyanız həmişə girişin aktiv olduğunu bilir:

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

Xətalar

Dəstək

İnteqrasiya köməyi, sandbox açarları və ya həcmi qiymətləndirmə: WhatsApp-da bizə mesaj göndərin. Adətən eyni gün cavab veririk.

Bütün emal, dəyişdirməyə icazə verilən fayllar üzərində həyata keçirilir.

Tez-tez verilən suallar

Cloud Tuning API ilə necə autentifikasiya edirəm?

Hər bir sorğu Bearer API açarından istifadə edir: başlığa Authorization: Bearer dvc_live_ göndərin.Açarları özünüz DaVinci Deluxe · Cloud Edition profilinizdə API parametrləri altında yaradır və ləğv edirsiniz.

Hansı proqramlaşdırma dilləri və platformalar istifadə edə bilərəm?

HTTPS sorğuları göndərə bilən istənilən dil və ya stack işləyir. Biz hazır PHP (WordPress / cPanel) və Python nümunələri təqdim edirik, REST API isə istənilən CMS, framework və ya hosting provayderi ilə inteqrasiya olunur.

Cloud Tuning API sinxron mu, asinxron mu?

Bu, asinxrondur. Siz bir iş təqdim edirsiniz, sonra ya iş-statusu son nöqtəsini yoxlayırsınız, ya da bir webhook URL təyin edirsiniz və işlənmiş fayl yükləməyə hazır olduğu anda imzalanmış geri çağırma göndəririk.

Hansı ECU həlləri və markalar dəstəklənir?

Anti-kirlilik və performans həlləri, DPF/FAP, EGR, AdBlue/SCR, DTC aradan qaldırılması, Lambda, MAF, Stage 1/2/3, Pops & Bangs və Hardcut daxil olmaqla Bosch, Continental, Siemens, Delphi, Marelli və daha çoxunu əhatə edir. Checksum və RSA avtomatik olaraq düzəldilir; dəstəklənməyən fayllar aydın səbəblə rədd edilir və heç vaxt ödəniş alınmır.

API sürət limitləri və maksimum fayl ölçüsü nədir?

API dəqiqədə 60 sorğuya qədər və hər iş üçün maksimum 50 MB fayl ölçüsünə icazə verir. Patlama limitini aşmaq HTTP 429 rate_limit_exceeded qaytarır; qısa bir gecikmədən sonra yenidən cəhd edin. Hər planın gündəlik fayl limiti var (Starter 100/gün, Business 500/gün, Enterprise limitsiz); bunu aşdıqda HTTP 429 daily_limit_reached qaytarılır.

Webhook geri çağırmalarının həqiqi olduğunu necə təsdiq edirəm?

Hər bir webhook, sizin whsec_ sirrinizlə HMAC-SHA256 ilə imzalanır və X-DvC-Signature başlığında təqdim edilir. İmzayı xam sorğu bədəninin üzərində yenidən hesablayın və geri çağırmanın həqiqətən DaVinci Deluxe · Cloud Edition-dan gəldiyini təsdiqləmək üçün müqayisə edin.