واجهة برمجة التطبيقات لتعديل السيارات السحابية

قم بدمج محرك معالجة ECU الخاص بنا مباشرة في منصتك. يقوم عميلك بتحميل ملف ECU على موقعك؛ ترسل الملف بالإضافة إلى الحلول التي تريدها؛ نُرجع لك الملف المعدل — يتم تصحيح checksum و RSA تلقائيًا — دون الحاجة إلى معالجة يدوية لأي واجهة ويب.

رابط أساسي: https://www.davincideluxe.fr/api/v1/cloud

يستخدم حسابك الحالي في DaVinci Deluxe · Cloud Edition. اشترك من خلال الدفع المعتاد عبر Stripe — يتم إنشاء مفتاح واجهة برمجة التطبيقات الخاص بك تلقائيًا ويظهر في ملفك الشخصي.

المصادقة

كل طلب يتم توثيقه بمفتاح واجهة برمجة التطبيقات السري المرسل كرمز Bearer. قم بإنشاء مفتاحك في لوحة التحكم الخاصة بك على 18|}/profile#api /profile#api بعد تفعيل خطة واجهة برمجة التطبيقات. يتم عرض المفتاح الخام مرة واحدة — احفظه بشكل آمن؛ نحن نحتفظ فقط بالهاش.

Authorization: Bearer dvc_live_xxxxxxxxxxxxxxxxxxxxxxxx

بداية سريعة

قدّم ملفًا مع الحلول التي تريدها ورابط رد. ستحصل على job_id على الفور، ثم ويب هوك موقع موقّع عندما يصبح الملف المعدل جاهزًا.

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

نقاط النهاية

قدّم مهمة

نوع المحتوى: multipart/form-data. أرسل الثنائي في الحقل file .

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

حالة الوظيفة

استعلام عن التقدم إذا كنت لا تستخدم webhooks. الحالة تتحرك عبر queued → processing → done (أو error).

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

تحميل النتيجة

تنقل الثنائي المصحح (checksum + RSA تم تطبيقه بالفعل). متاح بمجرد status = done.

قائمة الوظائف

يعود بأحدث وظائفك مع الحالة والطوابع الزمنية.

تحقق من التغطية (قبل التقديم)

يعود بتغطية المحرك الحية، والتغطية الحقيقية — بالضبط أي وحدات التحكم الإلكترونية والخدمات تتم معالجتها تلقائيًا الآن. استعلم عنها قبل التحميل حتى تقوم فقط بتقديم الملفات التي يمكن للمحرك التعامل معها؛ أي شيء خارج هذه القائمة مرفوض (ولن يتم تحميله أبدًا). الوضعين:

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

فهرس DTC (أكواد الأعطال)

يعود بفهرس DTC (كود العطل) لوحدة تحكم إلكترونية — نفس قائمة أكواد الأعطال الخاصة بكل وحدة تحكم إلكترونية كما هو معروض في تطبيق سطح المكتب، متاحة الآن برمجيًا. الوضعين:

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

الحالة

تحقق من صلاحية التسجيل. كما يوفر حالة اشتراكك في الرأس.

الحلول المغطاة

تتوفر عائلتان. حذف / تصحيحات تذهب في services المصفوفة؛ تعديل الأداء الإعدادات تذهب في tuning_options المصفوفة. يمكنك دمج كلاهما في عملية واحدة.

مكافحة التلوث والتصحيحات — services

• DPF / FAP
• EGR
• AdBlue / SCR
• إزالة رموز DTC
• Lambda / O2
• الصمامات / الالتواء
• NOx
• بدء وإيقاف
• إصلاح بدء التشغيل الساخن
• الاستعداد / OBD

تعديل الأداء — tuning_options

• المرحلة 1
• المرحلة 1+
• المرحلة 2
• المرحلة 3
• تعديل بيئي
• أصوات النقر والانفجارات
• أصوات النقر والانفجارات (قابل للتبديل)
• تحكم في الإطلاق
• حد قطع / محدد RPM
• تحويل E85

وحدات التحكم في المحرك والأنظمة المدعومة

تغطية مباشرة للمحرك — كل علامة تجارية، وحدة تحكم وحل

عتاد 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
• دلphi CRD2 / CRD3 / DDCR
• دينسو
• ماغنيتي ماريلي MJD / IAW / 8GMK
• فاليو VD46.x / VD56.x / J34 / V34
• فيستيون DCU102
• ZF (ناقل الحركة)

ماركات السيارات

• ألفا روميو
• أودي · فولكس فاجن · سيات · سكودا
• بي إم دبليو · ميني
• تشيري
• كرايسلر · دودج · جيب
• سيتروين · بيجو · دي إس
• داشيا
• ديتس
• فيراري
• فيات · لانشيا
• فورد
• جيلي
• الجدار العظيم
• هوندا
• هيونداي · كيا
• إيسوزو
• إيفيكو · CNH
• جاك
• جاجوار · لاند روفر
• كوبوتا
• ماهيندرا
• مان
• مازيراتي
• ماكسس · LDV
• مازدا
• مرسيدس-بنز · سمارت
• ميتسوبيشي
• نيسان
• أوبل · شيفروليه · فوكهول
• رينو
• سانغ يونغ
• سوبارو
• سوزوكي
• تويوتا · لكزس
• فولفو

تتم إضافة وحدات التحكم الإلكترونية الجديدة باستمرار — راجع القائمة الكاملة القابلة للبحث. إذا لم ترَ وحدة تحكم إلكترونية معينة، قدمها على أي حال — إذا لم نتمكن من معالجتها، سيتم رفض الطلب مع سبب واضح وبدون أي رسوم.

التوافق والتكامل

إنها واجهة برمجة تطبيقات HTTPS REST بسيطة، لذا فهي تعمل مع أي منصة أو لغة أو استضافة يمكنها إجراء طلب ويب واستقبال ويب هوك. لا حاجة لمكتبة SDK، لا برامج خاصة، لا اعتماد على الخادم من جانبنا.

الاستضافة والخوادم

• أي خادم VPS / خادم مخصص يعمل بنظام Linux
• cPanel / Plesk / استضافة مشتركة
• استضافة Node.js
• Windows Server / IIS
• السحابة (AWS، GCP، Azure، OVH، Hetzner…)
• بدون خادم (Cloudflare Workers، Vercel، Lambda)

المنصات ونظم إدارة المحتوى

• WordPress / WooCommerce (PHP)
• Joomla / Drupal / PrestaShop (PHP)
• Laravel / Symfony
• Node.js (Express، Next.js)
• Python (Django، Flask، FastAPI)
• أي موقع مخصص مع واجهة خلفية

مثال 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']

التحقق من ويب هوك 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

مثال 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"])

ويب هوك (استدعاءات غير متزامنة)

إذا قمت بتعيين webhook_url، نقوم بإرسال حدث JSON في اللحظة التي يصل فيها الطلب إلى حالة نهائية — job.completed أو job.failed. يتم إعادة المحاولة تلقائيًا للتسليم (60 ثانية، 5 دقائق، 30 دقيقة، حتى 4 محاولات) على أي استجابة غير 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"
}

التحقق من التوقيع

كل ويب هوك موقعة بمفتاحك الخاص سر السجل (whsec_...، يظهر مرة واحدة عند إنشاء المفتاح). احسب HMAC-SHA256 لـ نص الطلب الخام باستخدام ذلك السر وقارنه مع X-DvC-Signature الرأس.

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

حدود المعدل وحجم الملف

حالة اشتراكك تُعاد في كل اتصال موثق بحيث تعرف تكاملتك دائمًا أن الوصول نشط:

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

الأخطاء

الدعم

مساعدة التكامل، مفاتيح الصندوق الرملي، أو تسعير الحجم: راسلنا على واتساب. عادةً ما نرد في نفس اليوم.

يتم تنفيذ جميع المعالجات على الملفات التي لديك إذن لتعديلها.

الأسئلة المتكررة

كيف يمكنني المصادقة مع واجهة برمجة تطبيقات Cloud Tuning؟

كل طلب يستخدم مفتاح API Bearer: أرسل رأس Authorization: Bearer dvc_live_. يمكنك إنشاء وإلغاء المفاتيح بنفسك في ملفك الشخصي على DaVinci Deluxe · Cloud Edition تحت إعدادات API.

ما هي لغات البرمجة والمنصات التي يمكنني استخدامها؟

أي لغة أو مجموعة يمكنها إجراء طلبات HTTPS تعمل. نحن نقدم أمثلة جاهزة بلغة PHP (WordPress / cPanel) وPython، وتتكامل واجهة برمجة التطبيقات REST مع أي نظام إدارة محتوى أو إطار عمل أو مزود استضافة.

هل واجهة برمجة تطبيقات Cloud Tuning متزامنة أم غير متزامنة؟

إنها غير متزامنة. تقوم بتقديم وظيفة، ثم إما أن تستعلم عن نقطة نهاية حالة الوظيفة أو تعين عنوان URL لويب هوك وسنقوم بإرسال رد موقع في اللحظة التي يصبح فيها الملف المعالج جاهزًا للتنزيل.

ما هي حلول و علامات ECU المدعومة؟

حلول مكافحة التلوث والأداء بما في ذلك DPF/FAP، EGR، AdBlue/SCR، إزالة DTC، Lambda، MAF، Stage 1/2/3، Pops & Bangs وHardcut عبر Bosch وContinental وSiemens وDelphi وMarelli والمزيد. يتم تصحيح Checksum وRSA تلقائيًا؛ يتم رفض الملفات غير المدعومة مع سبب واضح ولا يتم فرض رسوم عليها أبدًا.

ما هي حدود معدل واجهة برمجة التطبيقات وأقصى حجم ملف؟

تسمح واجهة برمجة التطبيقات بما يصل إلى 60 طلبًا في الدقيقة وأقصى حجم ملف 50 ميجابايت لكل وظيفة. تجاوز حد الاندفاع يعيد HTTP 429 rate_limit_exceeded؛ حاول مرة أخرى بعد تأخير قصير. كل خطة أيضًا لديها حد يومي للملفات (Starter 100/يوم، Business 500/يوم، Enterprise غير محدود)؛ تجاوز ذلك يعيد HTTP 429 daily_limit_reached.

كيف يمكنني التحقق من أن ردود ويب هوك حقيقية؟

كل ويب هوك موقع باستخدام HMAC-SHA256 باستخدام سرك whsec_ الخاص بك ويتم تسليمه في رأس X-DvC-Signature. أعد حساب التوقيع على جسم الطلب الخام وقارنه لتأكيد أن الرد جاء حقًا من DaVinci Deluxe · Cloud Edition.