انقل مجموعة نطاقات بخطوات مفهومة

صُمم العمل الجماعي بحيث لا يتغير شيء حتى يرى شخص الخطة الدقيقة ويعتمدها. تحتاج إلى اتصال يملك portfolios:read وportfolios:write وportfolios:execute وapprovals:request، إضافة إلى نطاقات أذونات الكازا للإجراءات التي تخطط لها.

استورد الجرد

يقبل POST /workspaces/{id}/portfolios ملف CSV بترويسة item_key,domain,source_url,world_handle,template_id,content_language أو الحقول نفسها بوصفها items[]، حتى 1000 صف، مع preserve_existing_mx: true. يُفحص كل صف منفردًا: تُوحّد صيغ النطاقات وتُحظر التكرارات والعناوين غير الآمنة، ويُخزن النص الموجود في مصدر كبيانات غير موثوقة. لا يحدث شيء آخر بعد.

أعدّ خطة تشغيل تجريبي واقرأها

يقبل POST /workspaces/{id}/bulk-plans الإجراءات التي تريدها (create_draft وapply_import وset_dna وpublish وخطوات النطاق) وسقوف الميزانية وrollout_batches مثل [5, 95]: عينة تجريبية من خمسة ثم البقية. الرد بيان ثابت غير قابل للتعديل وقيمة plan_hash الخاصة به. اقرأه باستخدام GET /bulk-plans/{plan_id}: كل خطوة لكل عنصر وما ستغيره وكيف يمكن التراجع عنها. لا تمس خطوات DNS إلا سجلات الموقع وتبقي سجلات البريد كما هي. تنتهي صلاحية الخطط بعد 24 ساعة.

اطلب اعتماد المالك

يربط POST /workspaces/{id}/approvals قيمة plan_hash الدقيقة والسقوف وموعد انتهاء الصلاحية، ويعيد approval_url. لا يستطيع البت فيها إلا مالك في المتصفح بعد تسجيل الدخول مجددًا، بتأكيد قيمة التجزئة التي عُرضت عليه. لا تستطيع خطة متغيرة إعادة استخدام موافقة أبدًا، ولا يستطيع رمز منح الموافقة أبدًا.

نفّذ وراقب ووجّه

• يبدأ POST /bulk-plans/{plan_id}/execute مع plan_hash وapproval_id التشغيل الواحد الذي تسمح به الموافقة. تعمل الدفعة التجريبية أولًا؛ ويبدأ continue البقية.
• راقب GET /bulk-runs/{run_id} أو خطافات الويب job.updated وjob.item.updated.
• توجّه pause وresume وcancel وretry (لا تتكرر الخطوات المكتملة) التشغيل. ويتراجع rollback عما كتبه التشغيل ما دام لم يتغير بعد.

لا يمكن عكس التسجيلات والرسائل المرسلة وانتشار DNS الذي مضى، ولا يُبلغ عنها أبدًا على أنها أُلغيت بالتراجع. يوقف إلغاء الرمز العمل الجديد عند الخطوة التالية.

ما يعمل فعليًا اليوم

يعمل الاستيراد والتحقق وخطط التشغيل التجريبي والموافقات في كل البيئات. يعمل التنفيذ من البداية إلى النهاية مقابل موفري نطاق وDNS وشهادات محاكين في بيئات التطوير والاختبار، ويبقى معطلًا في الإنتاج حتى تتوفر اتصالات حقيقية بالموفرين. يبلغ GET /capabilities عن ذلك بوصفه bulk.execute.