انتقل إلى المحتوى
TLGPSالتوثيق

توثيق المطورين

توثيق المطورين

الوصول والنطاق

قدرات الشركة والصلاحيات ورؤية المركبات.

تجيب المصادقة وإتاحة الشركة والصلاحيات وقدرات الرموز ورؤية الموارد عن أسئلة مختلفة. ويُقيّم الوصول باستخدامها معًا.

قدرات الشركة

يجب تفعيل قدرة REST API أو Gateway المناسبة للشركة. الحساب النشط أو رمز الوصول لا يفعّل الخدمة تلقائيًا. نسّق تغييرات القدرات مع جهة مخوّلة في TLGPS.

صلاحيات المستخدم

تعتمد الصلاحيات الفعلية على مسؤولية الشخص والوصول المسند إليه ضمن قدرات الشركة المتاحة. لا يستطيع الرمز توسيع تلك الصلاحيات، ولا يعني نجاح تسجيل الدخول السماح بكل عملية.

قدرات الرمز

تحدد قدرة الرمز ما يمكن لبيانات الاعتماد المحددة محاولة تنفيذه. مثلًا، تسمح vehicles.view-any بمحاولة قراءة قائمة المركبات؛ ويظل صاحب الرمز بحاجة إلى الصلاحية الفعلية المطابقة ونطاق الموارد المسموح.

رؤية الشركات والمركبات

تقتصر النتائج على نطاق الرؤية الفعلي لصاحب الرمز. يمكن للشركة الوصول إلى أسطولها وإلى نطاق شركات إضافية أُتيح لها صراحةً. توسيع رؤية البيانات لا يفعّل قدرة تكامل ولا يحوّل الشركة الخارجية إلى مساحة بوابة يمكن اختيارها.

لا يكشف البحث المباشر عبر REST عن المركبات غير المتاحة. وترفض دفعات اشتراك Gateway المركبات غير المتاحة دون التمييز بين الموارد غير الموجودة والموارد غير المصرّح بها.

التغييرات أثناء الاتصال

يُقيّم REST الوصول مع الطلبات. ويعيد Gateway التحقق دوريًا؛ وقد تُزال اشتراكات أو يُغلق الاتصال عند تغير الوصول. لا تفترض سحب الوصول فورًا أو استمرار التحديثات دون انقطاع. بعد إعادة الاتصال، صادق مجددًا وأنشئ فقط الاشتراكات التي ما زالت مسموحة.

توثيق عام · يتطلب التكامل وصولًا مصرّحًا به

توثيق تديره فرق الهندسة. تستخدم الأمثلة بيانات توضيحية وقيَمًا بديلة لبيانات الاعتماد.

العودة إلى الأعلى