انتقل إلى المحتوى
نسخة تجريبية
سحابتي

مفاتيح API

كل ما يمكنك فعله في لوحة التحكم — تشغيل مثيل، سردها، قراءة تفاصيل الاتصال، التشغيل والإيقاف، النسخ الاحتياطي، تنفيذ الاستعلامات — مبني على الواجهة البرمجية نفسها. ومفاتيح مساحة العمل تتيح لك استدعاءها من نصوصك البرمجية ومن CI ومن وكلاء الذكاء الاصطناعي.

أنشئ مفتاحاً

من مساحة عملك، افتح صفحة مفاتيح API وأنشئ مفتاحاً جديداً. اختر اسماً وانسخ القيمة فوراً — تُعرض مرة واحدة فقط، ولا تعرض القائمة بعدها إلا أول أحرف منها. ويمكنك إلغاء أي مفتاح في أي وقت من الصفحة نفسها؛ يتوقف عن العمل فوراً.

كل مفتاح تنتهي صلاحيته — اختر 30 أو 90 أو 180 يومًا، أو سنة على الأكثر؛ وتعرض القائمة تاريخ كل مفتاح. ويتوقف المفتاح أيضًا عن العمل فور مغادرة من أنشأه مساحة العمل، أو تعليق حسابه، أو انتقاله إلى دور لم يعد يشمل ما يستطيعه المفتاح. والمفاتيح المنشأة قبل هذه القاعدة لا يُعرف منشئها: تبقى صالحة حتى 16 نوفمبر 2026 ثم تتوقف. وتَسِم القائمة كلًّا منها بهذا التاريخ، ويصل مالكي مساحة العمل ومشرفيها بريد واحد بشأنها؛ أنشئ مفتاحًا جديدًا بدل كل واحد منها. أما مفتاح تجديد kubeconfig فيسجّل من أُنشئ له، فلا يتأثر.

حدّد صلاحياته

ليس على المفتاح أن يرث كل ما تستطيعه أنت. يعرض نموذج الإنشاء موارد المنصّة — النسخ وتطبيقات الويب والشبكات والوحدات التخزينية والنطاقات ومفاتيح SSH والشهادات وموزّعات الحمل ومجموعات Kubernetes ومفاتيح API — والإجراءات المتاحة على كل مورد، فتختار ما يحتاجه هذا المفتاح بالضبط:

الموردالإجراءات
instanceإنشاء، قراءة، تعديل، حذف، دورة حياة، نسخ احتياطي، استعلام
projectإنشاء، قراءة، تعديل، حذف
network، volume، domainإنشاء، قراءة، تعديل، حذف
certificate، loadbalancerإنشاء، قراءة، تعديل، حذف
kubernetesإنشاء، قراءة، تعديل، حذف
sshKeyإنشاء، قراءة، حذف
apiKeyإنشاء، قراءة، تعديل، حذف

وفصل lifecycle (تشغيل/إيقاف/إعادة تشغيل) وquery (تنفيذ SQL) عن بقية العمليات مقصود: تشغيل خادم وتنفيذ جملة عليه خطر مختلف عن قراءة بياناته الوصفية، وسكربت النشر عادةً يريد أحدهما دون الآخر.

وread بيانات وصفية فقط — الحالة والعناوين والمقاييس والسجلات. ولا يصل أبداً إلى البيانات ولا إلى الأسرار: تنفيذ أي SQL، بما فيه SELECT، يتطلّب query؛ وكلمة المرور في تفاصيل اتصال النسخة وقيم متغيّرات التطبيق السرّية تتطلّب update (ويتلقّاها مفتاح القراءة فقط مقنّعة)؛ وتصدير قاعدة البيانات وعرض عمليات تصديرها وتنزيل ملفات خادم الألعاب تتطلّب backup.

وتدير إجراءات kubernetes المجموعات ومجمّعات عُقدها ووحدات تخزينها. ولا يحصل المفتاح أبداً على ملف kubeconfig، ولا يقرأ داخل مجموعة، ولا يغيّر من لديه وصول إليها أو من يستطيع الوصول إلى واجهتها، ولا يوقف حماية الحذف في مجموعة: فهذه كلها تحتاج إلى شخص مسجَّل الدخول.

وثمة قاعدتان تحدّان ما يمكنك إصداره:

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

وامنح المفتاح مدة صلاحية — حتى سنة — فيتوقف من تلقاء نفسه إن نسيته. فمفتاح CI الذي يعمّر أطول من الخط الذي كُتب له هو أكثر ما يُتوقّع تسريبه.

استخدمه

أرفقه في ترويسة x-api-key في طلباتك:

bash
curl "https://api.sahabti.com/v1/servers?orgId=$WORKSPACE_ID" \
  -H "x-api-key: $SAHABTI_TOKEN"

وإنشاء مثيل بالشكل نفسه:

bash
curl -X POST https://api.sahabti.com/v1/servers \
  -H "x-api-key: $SAHABTI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"engine":"postgres","name":"orders","plan":"small","orgId":"'"$WORKSPACE_ID"'"}'

وتغطي المسارات النسخ (الإنشاء والسرد والقراءة والتشغيل والإيقاف وإعادة التشغيل وإعادة التسمية وتغيير الحجم وإعادة المحاولة والحذف وتفاصيل الاتصال وسجل التجهيز والمقاييس واستخدام الحصة وتنفيذ SQL وقواعد الوصول الوارد والوصول العام)، والنسخ الاحتياطية، والتصدير والاستيراد، والشبكات، والنطاقات، ومفاتيح SSH، والشهادات، وموزّعات الحمل، ومجموعات Kubernetes، وتطبيقات الويب وعمليات نشرها، وطلبات زيادة الحصة. ولا يتوفّر بعد مرجع منشور للواجهة البرمجية.

وعمليات الكتابة تسجّل النية وتردّ فوراً — ثم تصل المنصّة إليها. فالسكربت الذي ينشئ مثيلاً ينبغي أن يستعلم عنه حتى يصبح قيد التشغيل، لا أن يفترض أن السطر التالي يمكنه الاتصال به.

ويعمل المفتاح باسم من أنشأه. ففي مساحة عمل تطلب التحقق بخطوتين لا يعمل إلا ما دام صاحبه مفعّلاً التحقق بخطوتين؛ وإلا ردّ كل طلب بـ 403 مع TWO_FACTOR_REQUIRED، ثم يعود إلى العمل بمجرد أن يفعّله. وبعض المفاتيح القديمة لا تسجّل من أنشأها، فتتوقف عن العمل في مساحة كهذه، لذا أنشئ مفتاحاً جديداً.

الخطوات التالية

السابقالنطاقات
التاليMCP لوكلاء الذكاء الاصطناعي