Caputchin
الأتمتة

أدِر Caputchin من الـ API

كل ما تستطيع فعله في لوحة التحكّم، ما عدا الفوترة، تستطيع فعله أيضًا من الكود. يكشف Caputchin API إدارة واحدًا، وثلاثة أسطح تجلس فوقه: API عبر HTTP هذا مباشرةً، وخادم MCP لوكلاء الذكاء الاصطناعي، ومزوّد Terraform وOpenTofu للبنية التحتية ككود. تختلف عند الحافّة فقط؛ التحقّق والصلاحيات وتسجيل التدقيق نفسها تنطبق أيًّا استخدمت.

الثلاثة جميعها تصادق بالاعتماد نفسه: رمز وصول تسكّه مرة.

اسكك رمز وصول

ترسل الرمز كترويسة Bearer. هناك نوعان، مغطّيان كاملًا تحت رمز الوصول الشخصي ورموز الفرق:

الرمزالامتداداسككه
رمز الوصول الشخصيرئيسي على حسابك كلهإعدادات الحساب. مجاني، واحد لكل حساب.
رمز وصول الفريقالفرق المرفق بها وحدها، بالصلاحيات الممنوحةصفحة رموز الفريق. يأخذ مقعدًا.

استخدم رمز وصول شخصيًّا لأتمتة حسابك الكامل؛ واستخدم رمز فريق للوصول المحصور بالامتياز الأدنى (مهمّة CI لا تلمس سوى فريق واحد). كلاهما يعمل في كل ما أدناه. تُعرَض قيمة الرمز مرة واحدة عند الإنشاء، فانسخها إلى مخزن أسرار.

الرابط الأساسي والمصادقة

API الإدارة مجذّر عند:

https://caputchin.com/api/v1/management

كل طلب يحمل الرمز كترويسة Bearer:

Authorization: Bearer cpt_pat_...

الطلبات والاستجابات JSON. نداء لا يُسمح لرمزك به يعيد 403؛ ورمز مجهول أو ملغًى يعيد 401.

مثال مشروح: إنشاء مفتاح موقع

لنقل إنك تريد مفتاح موقع جديدًا في فريقك shop-team. عدّد فرقك أولًا لإيجاد معرّفه، ثم أنشئ المفتاح فيه.

# 1. Find the troop id.
curl -s https://caputchin.com/api/v1/management/troops \
  -H "Authorization: Bearer $CAPUTCHIN_MANAGEMENT_TOKEN"
# → { "troops": [ { "id": "troop_…", "name": "shop-team", … }, … ] }

# 2. Create a site key in that troop.
curl -s -X POST https://caputchin.com/api/v1/management/sites \
  -H "Authorization: Bearer $CAPUTCHIN_MANAGEMENT_TOKEN" \
  -H "content-type: application/json" \
  -d '{ "name": "shop-frontend", "troop_id": "troop_…" }'
# → { "id": "site_…", "key": "cpt_pub_…", "secret": "cpt_sec_…", … }

تحمل الاستجابة key العام للمفتاح الجديد وsecret خاصته. يُعرَض السرّ مرة واحدة، هنا، فالتقطه الآن؛ ستـتحقّق به على خادمك الخلفي. أسقط troop_id فيحطّ المفتاح في فريقك Personal.

ذلك هو النمط كله: رمز Bearer، وجسم JSON، ونداء واحد لكل عملية. التعداد GET، والإنشاء POST، والتحديث PATCH أو PUT، والإزالة DELETE، مقابل مسارات الموارد تحت الرابط الأساسي.

المرجع الكامل

كل نقطة وصول، بمعاملاتها، ومخطّطات طلبها واستجابتها، ولوحة "جرّبها" مدمجة تصادق برمزك، في مرجع الـ API التفاعلي. إنه مولَّد من مواصفة OpenAPI نفسها التي بُني عليها الـ API، فلا ينحرف أبدًا عن السطح الحيّ. وجّه مولّدات عملائك إلى المواصفة المربوطة هناك.

انظر أيضًا

سجلّ تدقيق مفتاح الموقع

السابق

استخدم خادم MCP

التالي

في هذه الصفحة

اسكك رمز وصولالرابط الأساسي والمصادقةمثال مشروح: إنشاء مفتاح موقعالمرجع الكاملانظر أيضًا