Developer Ecosystem
ابنِ مستقبل التنقل على SyncVelo
واجهات مفتوحة وآمنة وبإصدارات لأجهزة أسطولك ومواقعها ورحلاتها وتنبيهاتها وتقاريرها وسائقيها، مع Webhooks موقّعة وحزمة TypeScript SDK وبيئة اختبار.
- REST وOpenAPI
- Webhooks موقّعة
- حزمة TypeScript SDK
- بيئة اختبار بمركبات محاكاة
1const api = 'https://api.syncvelo.com';2const { SYNCVELO_CLIENT_ID: id, SYNCVELO_CLIENT_SECRET: secret, SYNCVELO_ORG: org } = process.env;3 4const { access_token } = await fetch(`${api}/oauth/token`, {5 method: 'POST',6 headers: { Authorization: `Basic ${btoa(`${id}:${secret}`)}` },7 body: new URLSearchParams({ grant_type: 'client_credentials' }),8}).then((r) => r.json());9 10// Cursor pagination: follow next_cursor until it is null11let cursor: string | null = null;12do {13 const url = new URL(`${api}/v1/tenants/${org}/devices?limit=100`);14 if (cursor) url.searchParams.set('cursor', cursor);15 const page = await fetch(url, { headers: { Authorization: `Bearer ${access_token}` } }).then((r) => r.json());16 for (const d of page.items) console.log(d.id, d.status, d.latitude, d.longitude, d.speed_kph);17 cursor = page.next_cursor;18} while (cursor);واجهات الاتصال
كل طرق الاتصال، مع ضوابط مدمجة
صُممت كل واجهة مع التفويض وتعدد المستأجرين وقابلية التدقيق منذ اليوم الأول.
REST وOpenAPI العامة
الأجهزة والمواقع والرحلات والأسيجة الجغرافية والقواعد والتنبيهات والتقارير والسائقون، مع ترقيم بالمؤشرات وإصدارات صريحة.
الضوابط: بيانات اعتماد عميل OAuth2، ونطاقات الصلاحيات، وحدود المعدل، وحصص يومية.
Webhooks للأحداث
التنبيهات، والدخول إلى الأسيجة الجغرافية والخروج منها، والرحلات المكتملة، موقّعة ومُعاد إرسالها مع تباعد، وقابلة لإعادة الإرسال.
الضوابط: تدوير الأسرار دون فقدان أحداث؛ ومؤسسة واحدة لكل عميل.
حزمة TypeScript SDK
عميل مُحدَّد الأنواع مُولَّد من مستند OpenAPI؛ يتابع المؤشرات ولا يعيد المحاولة إلا حيث يكون ذلك آمنًا.
الضوابط: إصدارات دلالية واختبارات توافق.
بيئة الاختبار
مؤسسة منفصلة بمركبات محاكاة ورحلات نموذجية وWebhooks تجريبية، يُعاد ضبطها عند الطلب.
الضوابط: معزولة من الجذر: بلا مؤسسة أم ولا وصول إلى بيانات حقيقية.
صفحة المطورين في لوحة التحكم
عملاء API ونطاقاتهم ونقاط نهاية Webhooks، يديرها مالك المؤسسة، مع مرجع API.
الضوابط: تُعرض الأسرار مرة واحدة ولا تُحفظ إلا كبصمات.
إعادة التوجيه وMQTT
إعادة التوجيه إلى منصات أخرى وخوادم حكومية، وMQTT للمكاملين. ضمن الخطة (X5).
الضوابط: غير متاح اليوم.
REST وOpenAPI
واجهات API متوقعة السلوك تحترم المستأجرين
نقاط نهاية موجهة نحو الموارد مع ترقيم صفحات بالمؤشر، والتصفية، ومفاتيح تساوي القوة (idempotency keys)، وإصدارات صريحة. كل طلب يحمل سياسة المستأجر كاملة.
- بيانات اعتماد عميل OAuth2 مع نطاقات صلاحيات دقيقة
- معرّفات SyncVelo المرجعية، وليس مفاتيح المحرك الداخلية أبدًا
- مفاتيح تساوي القوة وإعادة محاولة آمنة لعمليات الكتابة
- حدود معدل وحصص يومية لكل عميل
1const api = 'https://api.syncvelo.com';2const { SYNCVELO_CLIENT_ID: id, SYNCVELO_CLIENT_SECRET: secret, SYNCVELO_ORG: org } = process.env;3 4const { access_token } = await fetch(`${api}/oauth/token`, {5 method: 'POST',6 headers: { Authorization: `Basic ${btoa(`${id}:${secret}`)}` },7 body: new URLSearchParams({ grant_type: 'client_credentials' }),8}).then((r) => r.json());9 10// Cursor pagination: follow next_cursor until it is null11let cursor: string | null = null;12do {13 const url = new URL(`${api}/v1/tenants/${org}/devices?limit=100`);14 if (cursor) url.searchParams.set('cursor', cursor);15 const page = await fetch(url, { headers: { Authorization: `Bearer ${access_token}` } }).then((r) => r.json());16 for (const d of page.items) console.log(d.id, d.status, d.latitude, d.longitude, d.speed_kph);17 cursor = page.next_cursor;18} while (cursor);Webhooks
أحداث لحظية، تُسلَّم بموثوقية
اشترك في التنبيهات (فتحها وزوالها والإقرار بها وإغلاقها)، والدخول إلى الأسيجة الجغرافية والخروج منها، والرحلات المكتملة. كل تسليم موقّع، ويُعاد مع تباعد، ويمكن إعادة إرساله خلال 30 يومًا.
- حمولات موقّعة بـ HMAC مع هامش تسامح للطابع الزمني
- إعادة محاولة تلقائية، وطابور للرسائل غير المُسلَّمة، وإعادة إرسال
- كتالوج أحداث بإصدارات في مستند OpenAPI
- سجلات التسليم في لوحة التحكم وعبر واجهة API
1POST /your/webhook2webhook-id: 6f0c2d2e-1b55-8a4e-9c3f-8f9a2b7d1e403webhook-timestamp: 17923164674webhook-signature: v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=5 6{7 "id": "6f0c2d2e-1b55-8a4e-9c3f-8f9a2b7d1e40",8 "type": "geofence.exited",9 "schema_version": "1.0",10 "organization_id": "1f7c…",11 "occurred_at": "2026-10-19T09:41:07.000Z",12 "created_at": "2026-10-19T09:41:08.214Z",13 "data": { "device_id": "8d2a…", "geofence_id": "c41e…" }14}SDK
عميل TypeScript مُحدَّد الأنواع، وREST مباشرة لكل ما عداه
تُولَّد حزمة TypeScript SDK من مستند OpenAPI وتُشارَك مع الوصول إلى بيئة الاختبار؛ وليست على سجل عام بعد. أما اللغات الأخرى فتستدعي واجهة REST API مباشرة.
TypeScript
للخوادم: Node.js 20+ وDeno وBun وبيئات الحافة. دوال مُحدَّدة الأنواع، ومتابعة المؤشرات، وإعادة محاولة آمنة، والتحقق من Webhooks.
import { SyncVelo } from '@syncvelo/sdk'أي لغة أخرى
Python أو Java أو Go أو أي لغة تتعامل مع HTTPS: استخدم واجهة REST API ومستند OpenAPI، كما في الأمثلة أعلاه.
GET https://api.syncvelo.com/openapi.json
دورة حياة التكامل
من أول مفتاح API إلى بيئة الإنتاج، بحوكمة شاملة
- 01
التسجيل
ينشئ المالك عميل API في صفحة المطورين في لوحة التحكم، بالنطاقات التي يحتاج إليها فقط.
- 02
التفويض
يبادل العميل معرّفه وسرّه برمز وصول قصير العمر (بيانات اعتماد عميل OAuth2).
- 03
الاشتراك
سجّل نقاط نهاية Webhooks، وأرسل أحداثًا تجريبية، وجرّب كل شيء في بيئة الاختبار أولًا.
- 04
التشغيل
حصص الاستخدام، وتساوي القوة، وإعادة المحاولة، وسياسة المستأجر كاملة في كل طلب.
- 05
المراقبة
سجلات التسليم، وإعادة إرسال ما فشل، وتدوير الأسرار وإلغاؤها.
بيئة اختبار المطورين
ابدأ البناء اليوم
احصل على مستأجر في بيئة الاختبار مع أجهزة محاكاة، ورحلات نموذجية، وWebhooks تجريبية. وصول المطورين متاح حاليًا لشركاء المرحلة التجريبية ومكاملي الأنظمة.
نماذج الأكواد في هذه الصفحة توضيحية. يُشارَك مرجع API الكامل عند منح الوصول إلى بيئة الاختبار.
ابدأ الآن
هل أنت مستعد لتحريك عالمك بذكاء أكبر؟
اكتشف كيف يمكن لـ SyncVelo أن تدعم أسطولك أو أعمالك كشريك أو تكاملك القادم. جولة شخصية، وأجهزة حقيقية، وحالة استخدامك أنت.