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

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

Gateway / V1

فحص الاتصال

اتصالات Gateway V1 واشتراكات المركبات والتحديثات المدعومة.

أرسل ping دوريًا خلال عمر الاتصال، ويجيب الخادم بـ pong. اختر فترة أقصر من مهلة الخمول التي أعلنها الاتصال. قد يغلق الخادم اتصالًا خاملًا أو غير مستجيب.

طلب فحص الاتصال

{
    "type": "ping",
    "data": {}
}

رد فحص الاتصال

{
    "type": "pong",
    "timestamp": "2026-06-30T19:38:34+02:00",
    "data": {}
}

لا تتطلب رسائل الفحص اشتراكًا ولا تحمل تتبعًا. استمر في إرسالها أثناء الاشتراكات. بعد الانقطاع صادق على اتصال جديد وأعد الاشتراكات؛ إرسال الفحص لا يعيد اتصالًا مغلقًا.

أسباب الإغلاق

تشمل الأسباب المعرفة في البروتوكول heartbeat_timeout وduplicate_authentication وserver_shutdown وmaintenance وunauthorized وprotocol_violation. تعامل مع الإغلاق نفسه، ولا تعتمد على وصول رسالة أخيرة في كل ظرف.

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

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

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