ماذا نفحص؟
لكل إضافة ثبّتها، نجري استدعاءً غير ضار للقراءة فقط على واجهة API الخاصة بالخدمة (نقطة نهاية من نوع 'من أنا؟'). يتحقّق ذلك من أن مفتاح API ما زال يعمل، دون جلب بيانات العملاء أو تغيير أي شيء.
- Gecko Booking: GET /api/v1/customer?rowsPerPage=1
- Billy: GET /v2/organization
- Cal.com: GET /v2/me
- Calendly: GET /users/me
- Pipedrive: GET /v1/users/me
- Shipmondo: GET /api/public/v3/account
متى يُجرى الفحص؟
أيام الاثنين في الساعة 06:00 بالتوقيت العالمي المنسّق (≈ 08:00 بتوقيت وسط أوروبا). كل يوم اثنين، جميع الإضافات المثبّتة. يمكنك أيضاً إجراء الفحص يدوياً في أي وقت بالنقر على 'اختبار الاتصال' في صفحة تفاصيل الإضافة.
تظهر النتيجة كشارة 'نشط' / 'فشل' / 'لم يُختبَر' في صفحة الإضافة، إلى جانب 'آخر اختبار قبل مدة X'.
ماذا يحدث إذا فشل؟
- تتحوّل حالة الإضافة إلى 'فشل' وتُحفَظ رسالة الخطأ (عادةً 'مفتاح API غير صالح' أو رمز حالة HTTP).
- نرسل إليك رسالة واحدة عن المشكلة — ولا مزيد حتى يعمل مجدداً أو يظهر نوع جديد من الأخطاء.
- لا يزال بإمكان الذكاء الاصطناعي كتابة المسودات، لكنه لم يعد قادراً على استدعاء الإضافة المتعطّلة أثناء الصياغة. وتستمر إضافاتك الأخرى في العمل باستقلالية.
- تصلح ذلك بإدخال مفتاح API جديد في صفحة تفاصيل الإضافة — ونختبر المفتاح الجديد فوراً قبل الحفظ.
لماذا ليس بوتيرة أكثر تكراراً؟
نريد أن نبقى مواكبين دون إغراق واجهات API التابعة لأطراف ثالثة، ودون مراسلتك كل يوم لأن مفتاحاً قد تعطّل منذ يوم الثلاثاء. الوتيرة الأسبوعية تحقّق هذا التوازن — ولديك دائماً زر 'اختبار الاتصال' إذا راودك الشك.