اكتشف معرّفات الخدمات قبل الاستعلام الدوري
ابدأ بنقطة نهاية الخدمات للعثور على المعرّف الذي يستخدمه UptimeScout. لا يطابق الاسم المعروف للعلامة التجارية معرّف API دائمًا. احتفظ بالمعرّف والمنطقة ضمن إعدادات تطبيقك لضمان أن تشير طلبات الحالة والسجل إلى الخدمة نفسها.
احصل على ترخيص مؤهل عبر Evelode واحتفظ به في سر على جانب الخادم أو في متغير بيئة. لا تضمّن مفتاحًا مدفوعًا في JavaScript المتصفح أو مستودع عام أو لقطة شاشة أو عنوان URL.
أرسل طلب حالة مصادقًا عليه
عيّن EVELODE_LICENSE_KEY في بيئتك قبل تشغيل المثال. يطلب هذا المثال ملاحظات GitHub لمنطقة US؛ وهو قالب طلب وليس ادعاءً بشأن الحالة الحالية لـ GitHub.
curl -G https://api.uptimescout.com/v1/status \
--data-urlencode "service=github" \
--data-urlencode "region=US" \
-H "Authorization: Bearer $EVELODE_LICENSE_KEY"فسّر الاستجابة قبل عرضها
تختلف استجابة النقل الناجحة عن مؤشر توافر الخدمة؛ فهما طبقتان منفصلتان. تحقّق أولًا من حالة HTTP وبنية الاستجابة، ثم افحص service.status وservice.observed_at وservice.stale. وأبقِ unknown والبيانات القديمة ظاهرة بدلًا من معاملتها بصمت على أنها operational.
احفظ المنطقة إلى جانب وقت الملاحظة. إذا كانت واجهتك تحدّث نفسها كل دقيقة، فاعرض وقت الملاحظة منفصلًا عن وقت جلب تطبيقك للاستجابة. فقد تصف استجابة HTTP حديثة ملاحظة أقدم.
خطط لحجم الطلبات وتعامل مع الحدود
استخدم statuses عندما تناسب مجموعة الخدمات سير عملك، وراجع الحد الأقصى لحجم الدفعة في الخطة المختارة. يختلف رصيد الطلبات عن عدد الطلبات في الدقيقة. وتشترك REST وSDK وMCP في محاسبة الطلبات المرخّصة نفسها.
عند ظهور HTTP 429، التزم بترويسة Retry-After وتجنب موجة من المحاولات الفورية. استخدم عددًا محدودًا من المحاولات مع زيادة التأخير عند حدوث أعطال مؤقتة، ولا تكرر إلى ما لا نهاية طلبات المصادقة أو المعلمات غير الصالحة. ويحدّث التجديد وتغيير الخطة الرصيد المرخّص؛ ولا تحدث إعادة ضبط في أول يوم من الشهر الميلادي.
اختبر الحالات غير المؤكدة قبل الإطلاق
اختبر خدمة معروفة ومعرّفًا غير معروف ومفتاحًا مفقودًا ومعلمات غير صالحة وملاحظة قديمة أو مفقودة. وتأكد من أن هذه الحالات تنتج رسائل مفيدة في واجهتك. لا تضع نتائج التشخيص الكاملة في سجلات عامة إذا كانت تتضمن بيانات اعتماد أو معلومات حساب.
تتضمن وثائق API الطرق العامة السبع ومخطط OpenAPI. وتوفر jsonscraper روابط لحزم SDK الخاصة بـ Python وNode.js وPHP وGo وJava و.NET. تسهّل مكتبة العميل عملية النقل، لكن يظل تطبيقك بحاجة إلى سياسة لتفسير عدم اليقين.
رُوجع المحتوى في 18 نوفمبر 2026.
Markdown


