للمطوّرين
مرجع واجهة البرمجة (API)
واجهة برمجة تطبيقات لإدارة عمليات النشر والنطاقات وسجلات DNS والمشاريع وتذاكر الدعم على منصّة محسومة كلاود.
مسودة التصميم — آخر تحديث 2026
نظرة عامة
توثّق هذه الصفحة الشكل المخطّط لواجهة برمجة تطبيقات محسومة كلاود العامّة. تتيح الواجهة إدارة البنية التحتية للاستضافة برمجياً: إنشاء عمليات النشر، وربط النطاقات، وإدارة سجلات DNS، ومتابعة المشاريع، وفتح تذاكر الدعم.
الحالة: واجهة البرمجة العامّة قيد التطوير — متاحة عند الطلب. الأمثلة الواردة أدناه تصف التصميم المخطّط وليست نقاط نهاية فعّالة بعد. اليوم تُدار عمليات النشر والاستضافة من خلال لوحة التحكّم وتكامل GitHub.
عنوان الأساس
ستُقدَّم جميع الطلبات إلى العنوان التالي (مخطّط):
https://cloud.mahsumaah.sa/apiجميع الطلبات والاستجابات بصيغة JSON، وتُرسَل عبر HTTPS فقط.
المصادقة
قريباً
لا نُصدر مفاتيح واجهة برمجة عامّة بعد. المخطّط أن تُصادَق الطلبات باستخدام رمز حامل (Bearer token) يُنشأ من لوحة التحكّم. المثال التالي يوضّح التصميم المخطّط فقط:
curl https://cloud.mahsumaah.sa/api/projects \
-H "Authorization: Bearer mc_live_xxxxxxxxxxxxxxxxxxxx"احفظ الرمز في مكان آمن؛ فهو يمنح كامل الصلاحيات على حسابك. سيتيح التصميم النهائي إبطال الرموز وتحديد نطاق صلاحياتها.
عمليات النشر
مخطّط
أنشئ عملية نشر جديدة لمشروع، أو استعلم عن حالة نشرٍ قائم. تُبنى المشاريع وتُنشر على بنيتنا التحتية في الرياض.
curl -X POST https://cloud.mahsumaah.sa/api/deployments \
-H "Authorization: Bearer mc_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"project": "mena-studio",
"ref": "main",
"production": true
}'{
"id": "dpl_8Kd2mQ",
"project": "mena-studio",
"state": "BUILDING",
"ref": "main",
"commit": "a1b2c3d",
"production": true,
"url": "https://mena-studio.mahsumaah.sa",
"region": "riyadh",
"createdAt": "2026-08-11T09:20:00Z"
}النطاقات
مخطّط
اربط نطاقاً مخصّصاً بمشروع، وتحقّق من حالة التفعيل وشهادة SSL. تُصدَر شهادات SSL وتُجدَّد تلقائياً.
curl -X POST https://cloud.mahsumaah.sa/api/domains \
-H "Authorization: Bearer mc_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"project": "mena-studio",
"name": "menastudio.sa"
}'{
"name": "menastudio.sa",
"project": "mena-studio",
"verified": false,
"ssl": "PENDING",
"nameservers": ["ns1.mahsumaah.sa", "ns2.mahsumaah.sa"],
"createdAt": "2026-08-11T09:22:00Z"
}سجلات DNS
مخطّط
أدر سجلات DNS للنطاقات المستضافة على خوادم الأسماء الخاصّة بنا (ns1/ns2.mahsumaah.sa).
curl -X POST https://cloud.mahsumaah.sa/api/dns/menastudio.sa/records \
-H "Authorization: Bearer mc_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"type": "A",
"name": "@",
"value": "212.0.0.10",
"ttl": 3600
}'{
"id": "rec_Lp9tZ",
"domain": "menastudio.sa",
"type": "A",
"name": "@",
"value": "212.0.0.10",
"ttl": 3600,
"createdAt": "2026-08-11T09:25:00Z"
}المشاريع
مخطّط
اعرض المشاريع المرتبطة بحسابك واستعلم عن إعداداتها ومستودع GitHub المرتبط بها.
curl https://cloud.mahsumaah.sa/api/projects \
-H "Authorization: Bearer mc_live_xxx"{
"projects": [
{
"id": "prj_3Vn7a",
"name": "mena-studio",
"framework": "nextjs",
"repo": "menastudio/website",
"region": "riyadh",
"productionUrl": "https://mena-studio.mahsumaah.sa"
}
]
}تذاكر الدعم
مخطّط
افتح تذكرة دعم أو تابع حالتها برمجياً. الدعم عبر التذاكر متاح اليوم من داخل لوحة التحكّم.
curl -X POST https://cloud.mahsumaah.sa/api/tickets \
-H "Authorization: Bearer mc_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"subject": "Custom domain not verifying",
"priority": "normal",
"message": "menastudio.sa still shows PENDING after 24h."
}'{
"id": "tkt_5Wq1x",
"subject": "Custom domain not verifying",
"status": "OPEN",
"priority": "normal",
"createdAt": "2026-08-11T09:30:00Z"
}طلب وصول مبكّر
واجهة البرمجة في مرحلة الوصول المبكّر. اطلب وصولك وسنشارك مفتاحاً تجريبياً بمجرّد جاهزيته، أو تحدّث مع فريقنا لمناقشة التكامل مع أنظمتك.
ذات صلة: تكامل GitHub · أدوات المطوّرين · المنتجات · النطاقات و DNS