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

المناطق

تقيم بيانات مؤسستك في منطقة واحدة وتبقى فيها. المؤسسات في دول الخليج (السعودية والإمارات وقطر والكويت والبحرين وعُمان) في المنطقة gcc.

الاسم العام​

استدعِ https://api.zaitrack.app كما تفعل كل الأمثلة هنا. تختار الحافة المنطقة لكل طلب:

  1. رمز وصول OAuth (لتطبيق أو لشخص سجّل الدخول): تختار منطقتَك مطالبةُ region الموثّقة فيه.
  2. الترويسة X-Zaitrack-Region (مثل X-Zaitrack-Region: gcc)، إن أرسلتها، تختار تلك المنطقة.
  3. مفتاح الواجهة أو رمز الوصول الشخصي لا يحمل منطقة، فيذهب الطلب إلى المنطقة الافتراضية gcc. وإن كانت مؤسستك في منطقة أخرى تجيب تلك البوابة بـ 421 Misdirected Request مع مضيف منطقتك في Location:
HTTP/2 421
Location: https://api.eu-west.zaitrack.app/v1/vehicles
Content-Type: application/problem+json

اتبعه مرة واحدة، ثم استدعِ مضيف منطقتك مباشرة أو أرسل X-Zaitrack-Region. المؤسسة الخليجية لا تحتاج إلى أيّ منهما. وحين ترفض الحافة نفسها الطلب (مضيف مجهول، أو رمز تخالف منطقته المضيف) يحمل الرد 421 أيضًا X-Zaitrack-Reason: region.misroute.

يذكر كل رد المنطقة التي خدمته في X-Zaitrack-Region.

مضيفو المناطق​

مضيف كل منطقة ما زال يعمل مباشرة. استخدمه لتثبيت الطلبات في منطقة واحدة من أجل إقامة البيانات:

المنطقةالمضيفالإقامة
gccapi.gcc.zaitrack.appالخليج
eu-westapi.eu-west.zaitrack.appالاتحاد الأوروبي
us-eastapi.us-east.zaitrack.appالولايات المتحدة
us-westapi.us-west.zaitrack.appالولايات المتحدة
apac-southapi.apac-south.zaitrack.appآسيا والمحيط الهادئ

المسارات والنطاقات والحدود هي نفسها على كل مضيف؛ وتحمل ردود مضيفي المناطق أيضًا X-Zaitrack-Residency. وعلى مضيف منطقة تتحقق الحافة من منطقة رمز OAuth ومن الترويسة X-Zaitrack-Region مقابل المضيف، وتجيب بـ 421 مع المضيف الصحيح في Location إن اختلفا.

تسجيل الدخول​

تسجيل الدخول عام: يخدم auth.zaitrack.app كل المناطق.