الحصول على الوصول
تُنشأ بيانات الاعتماد في استوديو المطوّرين. سجّل الدخول بحسابك في ZAITRACK؛ يعمل الاستوديو باسمك داخل مؤسستك.
من يستطيع ماذا
ما يمكنك تغييره في استوديو المطوّرين يتبع دورك في المؤسسة:
| الإجراء | يتطلب |
|---|---|
| إنشاء مفاتيح الواجهة وصناديق التجربة | tenancy:write (المالكون) |
| تسجيل تطبيقات OAuth | identity:write (المالكون والمسؤولون) |
| إنشاء خطافات الويب | webhooks:* (المالكون والمسؤولون) |
| قراءة تطبيقات OAuth وحدود المعدّل وحسابك | أي عضو |
الصفحة التي لا تستطيع استخدامها تذكر الصلاحية التي تنقصك.
طلبك الأول
- أنشئ صندوق تجربة. في استوديو المطوّرين: صناديق التجربة ← إنشاء صندوق تجربة. تحتفظ المؤسسة بثلاثة على الأكثر. راجع صناديق التجربة ومفاتيح الاختبار.
- أنشئ مفتاح اختبار. مفاتيح الواجهة ← إنشاء مفتاح، واختر test وحدّد صندوق التجربة. اختر النطاقات
التي يحتاج إليها التكامل؛ لا يمكنك منح نطاق لا تملكه. يظهر المفتاح (
zk_test_…) مرة واحدة: احفظه في مدير الأسرار لديك. - استدعِ الواجهة. صندوق التجربة الجديد فارغ، فتعيد القائمة صفر عناصر:
curl "https://api.zaitrack.app/v1/vehicles" \
-H "Authorization: Bearer zk_test_…"
{"items": [], "nextCursor": ""}
- أنشئ شيئًا. بالنطاق
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 فئات الأصول الممكنة للمركبة. ويذكر مرجع الواجهة البرمجية
كل حقل.
التالي
- المصادقة: مفاتيح الواجهة ورموز الوصول الشخصية وتطبيقات OAuth.
- الأخطاء: كيف يبدو الرفض.
- أمثلة عملية: مهام كاملة على عمليات حقيقية.