تعمل لوحة التحكم جيدًا لمهمة واحدة تضم 20 حسابًا. لكنها أقل ملاءمة عندما تحتاج بيئة staging إلى صناديق جديدة مع كل نشر، أو عندما ينشئ المنتج حسابات أثناء إعداد عميل. وُجدت API لهذه الحالات.
تمنح الخطة السنوية وصول REST لإرسال المهام وفحص الحالة وإدخال النتائج إلى نظامك. تشمل الاستخدامات الشائعة خطوط CI ولوحات الإدارة والأدوات الداخلية. لا تسجل بيانات الاعتماد الناتجة في السجلات، بل انقلها إلى مخزن معتمد.
ما الذي تتم أتمتته عادةً؟
- CI/CD: تجهيز 10 حسابات Gmail للاختبار عند نشر فرع staging.
- إعداد العملاء: توفير صناديق عندما تنضم مؤسسة إلى المنتج.
- ضمان الجودة: توفير حسابات جديدة لاختبارات Playwright أو Selenium.
- العمليات الداخلية: زر ينشئ 50 حساب Yahoo لمشروع محدد.
مسار التكامل الأساسي
- 1اشترك في الخطة السنوية وأنشئ مفتاحًا من Dashboard → API.
- 2أرسل `POST /tasks` مع المزوّد (`gmail` أو `yahoo` أو `outlook`) والعدد وخيارات الاسم.
- 3احفظ `task_id` الناتج فورًا.
- 4تحقق من `GET /tasks/{id}` كل 30 إلى 60 ثانية حتى تصبح الحالة `completed` أو `failed`.
- 5اجلب القائمة عبر نقطة نهاية تفاصيل المهمة وزامنها مع قاعدة البيانات.
النتائج ليست فورية
لا تحجب الواجهة أثناء الانتظار. قد تستغرق مهمة تضم 50 حساب Gmail بين 30 و90 دقيقة. أعد معرّف المهمة وأبلغ المستخدم عند الاكتمال عبر webhook أو البريد أو تحقق الواجهة الخلفية.
الأمان: متطلبات إلزامية
| القاعدة | السبب |
|---|---|
| المفتاح في الواجهة الخلفية فقط | يمكن إساءة استخدام المفتاح الظاهر في الواجهة الأمامية |
| مفتاح لكل بيئة | لا يعرّض تسرب staging الإنتاج للخطر |
| دوّر المفاتيح دوريًا | يحد من أثر التسرب |
| شفّر كلمات المرور المخزنة | كلمات المرور بيانات سرية |
| سجّل معرّفات المهام لا كلمات المرور | يتيح تصحيح الأخطاء من دون كشف بيانات اعتماد |
عند حدوث مشكلة
- قد يكون النجاح جزئيًا. افحص حالة كل حساب وأعد محاولة الحالات الفاشلة في مهمة جديدة.
- احترم حدود الاستخدام. زد مدة الانتظار من 30 إلى 60 ثم 120 ثانية.
- إذا بقيت المهمة `processing` أكثر من ثلاث ساعات، فسجّلها وأنشئ تنبيهًا. لا تفترض فشلها ثم تنشئ نسخة مكررة.
- احفظ `task_id` قبل التحقق. إذا توقف السكربت، فاستأنف المهمة نفسها بدل بدء مهمة أخرى.
وثائق API
تتوفر مراجع نقاط النهاية وصيغ الطلب والاستجابة وترويسات المصادقة في لوحة التحكم ضمن API Access بعد الاشتراك في الخطة السنوية.
الإنشاء هو المرحلة الأولى فقط من الأتمتة. استخدم دليل تكامل أدوات التواصل للتسليم إلى منصة الإرسال، وسير توفير الحسابات للموافقات والملكية والتخزين والإغلاق.