راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
أضف ساعة بالتوقيت المحلي إلى لوحة الدعم
وكيل الدعم الذي يقرر ما إذا كان سيتصل بعميل الآن يستفيد من معرفة الوقت الفعلي في مكان وجود ذلك العميل، لا الوقت في المكتب.
الحصول على المنطقة الزمنية للعميل
إذا كان لديك عنوان شحن أو فوترة محفوظ، فطبّق عليه الترميز الجغرافي مرة واحدة للحصول على الإحداثيات، ثم مرّر تلك الإحداثيات إلى /v1/timezone. وإذا كان كل ما لديك هو عنوان IP من زيارته الأخيرة، فإن نقطة النهاية /v1/ip تعيد الحقل timezone مباشرة، دون استعلام منفصل.
GET /v1/timezone?lat=35.6762&lon=139.6503{
"status": "ok",
"timezone": "Asia/Tokyo",
"utc_offset": "+09:00",
"abbreviation": "JST"
}عندما لا يتوفر عنوان ولا IP محفوظ
بالنسبة لعميل محتمل أو تذكرة دون عنوان ودون IP مسجل، لا توجد إحداثيات موثوقة للبحث عن المنطقة الزمنية بها، والتخمين بناءً على رمز الدولة في رقم الهاتف أو إعداد اللغة ليس شيئًا تستطيع نقطة النهاية هذه فعله لك. في هذه الحالة اطلب المنطقة الزمنية أو موقعًا تقريبيًا مباشرة، بدلًا من عرض ساعة مبنية على تخمين يحتمل فعلًا أن يخطئ بعدة ساعات.
عرض الساعة
خزّن معرّف المنطقة الزمنية مع سجل العميل، ثم احسب التوقيت المحلي الحالي منه كلما عُرضت لوحة التحكم، بدلًا من تخزين فارق ثابت سيصبح قديمًا عند تغييرات التوقيت الصيفي. وبما أن الموقع لا يحتوي على JavaScript من جهة العميل، فاعرض التوقيت المحلي الحالي من جهة الخادم عند تحميل الصفحة وحدّثه مع كل طلب للصفحة بدلًا من تشغيله مباشرة في المتصفح.
استعلام واحد لكل عميل، لا لكل مشاهدة صفحة
معرّف المنطقة الزمنية لموقع العميل لا يتغير من يوم لآخر، لذا ابحث عنه مرة واحدة عند تسجيل العنوان أو IP لأول مرة وخزّن المعرّف، بدلًا من استدعاء API في كل مرة تُحمَّل فيها لوحة التحكم. وهذا يُبقي هذه الميزة عند عدد قليل من الطلبات إجمالًا بدلًا من طلب لكل مشاهدة صفحة، وهو أمر مهم إذا كان فريق الدعم يفتح لوحة التحكم مرات عديدة يوميًا.
خطأ يستحق التجنب
إعادة حساب الفارق لتفاعل دعم سابق باستخدام استعلام المنطقة الزمنية لليوم، بدلًا من الطابع الزمني للتفاعل نفسه، قد تعرض ساعة خاطئة حول تغيير التوقيت الصيفي. إذا احتاجت لوحة التحكم إلى عرض التوقيت المحلي الذي كان لدى العميل لحظة تقديم تذكرة سابقة، فمرّر الطابع الزمني لتلك التذكرة نفسها عبر المعامل time بدلًا من الاعتماد على الفارق الحالي.
كم يكلف
حتى دون تخزين المعرّف مؤقتًا، كل استعلام هو طلب واحد، لذا يتسع فريق دعم بأي حجم معقول بسهولة ضمن 2,500 طلب مجاني يوميًا المضمنة مع كل مفتاح، أو الحصة نفسها من عنوان واحد بدون مفتاح.
إبقاء البيانات محدّثة
إذا تغيّر العنوان المحفوظ للعميل، فحدّث معرّف المنطقة الزمنية المخزن في الوقت نفسه، بدلًا من ترك معرّف قديم مرتبط بالسجل إلى أجل غير مسمى. فالعميل الذي انتقل ولديه معرّف منطقة زمنية قديم سيظهر له توقيت محلي خاطئ حتى يُحدَّث السجل، وذلك بصمت، لأن الاستعلام القديم لا يفشل ولا يُصدر خطأ من تلقاء نفسه.
ساعة بالتوقيت المحلي بجانب التذكرة إضافة صغيرة توفر على وكيل الدعم إجراء حسابات المناطق الزمنية في ذهنه قبل كل مكالمة. يشرح توثيق الاستعلام عن المنطقة الزمنية الطلب بالكامل.