المناطق
تقيم بيانات مؤسستك في منطقة واحدة وتبقى فيها. المؤسسات في دول الخليج (السعودية والإمارات وقطر والكويت والبحرين
وعُمان) في المنطقة gcc.
الاسم العام
استدعِ https://api.zaitrack.app كما تفعل كل الأمثلة هنا. تختار الحافة المنطقة لكل طلب:
- رمز وصول OAuth (لتطبيق أو لشخص سجّل الدخول): تختار منطقتَك مطالبةُ
regionالموثّقة فيه. - الترويسة
X-Zaitrack-Region(مثلX-Zaitrack-Region: gcc)، إن أرسلتها، تختار تلك المنطقة. - مفتاح الواجهة أو رمز الوصول الشخصي لا يحمل منطقة، فيذهب الطلب إلى المنطقة الافتراضية
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.
مضيفو المناطق
مضيف كل منطقة ما زال يعمل مباشرة. استخدمه لتثبيت الطلبات في منطقة واحدة من أجل إقامة البيانات:
| المنطقة | المضيف | الإقامة |
|---|---|---|
gcc | api.gcc.zaitrack.app | الخليج |
eu-west | api.eu-west.zaitrack.app | الاتحاد الأوروبي |
us-east | api.us-east.zaitrack.app | الولايات المتحدة |
us-west | api.us-west.zaitrack.app | الولايات المتحدة |
apac-south | api.apac-south.zaitrack.app | آسيا والمحيط الهادئ |
المسارات والنطاقات والحدود هي نفسها على كل مضيف؛ وتحمل ردود مضيفي المناطق أيضًا X-Zaitrack-Residency. وعلى
مضيف منطقة تتحقق الحافة من منطقة رمز OAuth ومن الترويسة X-Zaitrack-Region مقابل المضيف، وتجيب بـ 421 مع
المضيف الصحيح في Location إن اختلفا.
تسجيل الدخول
تسجيل الدخول عام: يخدم auth.zaitrack.app كل المناطق.