إنتقل إلى المحتوى الرئيسي

الحصول على الوصول

تُنشأ بيانات الاعتماد في استوديو المطوّرين. سجّل الدخول بحسابك في ZAITRACK؛ يعمل الاستوديو باسمك داخل مؤسستك.

من يستطيع ماذا​

ما يمكنك تغييره في استوديو المطوّرين يتبع دورك في المؤسسة:

الإجراءيتطلب
إنشاء مفاتيح الواجهة وصناديق التجربةtenancy:write (المالكون)
تسجيل تطبيقات OAuthidentity:write (المالكون والمسؤولون)
إنشاء خطافات الويبwebhooks:* (المالكون والمسؤولون)
قراءة تطبيقات OAuth وحدود المعدّل وحسابكأي عضو

الصفحة التي لا تستطيع استخدامها تذكر الصلاحية التي تنقصك.

طلبك الأول​

  1. أنشئ صندوق تجربة. في استوديو المطوّرين: صناديق التجربة ← إنشاء صندوق تجربة. تحتفظ المؤسسة بثلاثة على الأكثر. راجع صناديق التجربة ومفاتيح الاختبار.
  2. أنشئ مفتاح اختبار. مفاتيح الواجهة ← إنشاء مفتاح، واختر test وحدّد صندوق التجربة. اختر النطاقات التي يحتاج إليها التكامل؛ لا يمكنك منح نطاق لا تملكه. يظهر المفتاح (zk_test_…) مرة واحدة: احفظه في مدير الأسرار لديك.
  3. استدعِ الواجهة. صندوق التجربة الجديد فارغ، فتعيد القائمة صفر عناصر:
curl "https://api.zaitrack.app/v1/vehicles" \
-H "Authorization: Bearer zk_test_…"
{"items": [], "nextCursor": ""}
  1. أنشئ شيئًا. بالنطاق vehicles:write:
curl -X POST "https://api.zaitrack.app/v1/vehicles" \
-H "Authorization: Bearer zk_test_…" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"make": "Volvo", "model": "FH16", "year": 2024, "assetClass": "heavy-truck",
"registration": {"country": "SA", "plate": "ABC 1234"}, "fuelType": "diesel"}'

تعيد GET /v1/asset-classes فئات الأصول الممكنة للمركبة. ويذكر مرجع الواجهة البرمجية كل حقل.

التالي​