مرجع CLI لـ techstack api - kombify

مولَّد من إصدار Techstack v0.32.8 (المصدر 4c7d219a5d56). بالنسبة إلى إصدار مثبَّت، فإن techstack api <command> --help هو المرجع.

يستدعي techstack api واجهة Techstack API تماماً كما يصفها مرجع API: أمر واحد لكل عملية عامة، مولَّد من عقد API الخاص بالإصدار. يطبع كل أمر JSON على stdout بعد إزالة غلاف الاستجابة؛ وتذهب الأخطاء إلى stderr ككائن خطأ منظَّم.

المصادقة

المتغير	المعنى
`TECHSTACK_API_URL`	عنوان URL الأساسي لـ API. القيمة الافتراضية `https://api.kombify.io/v1/techstack`؛ اضبطه على عنوان مثيل Techstack الخاص بك لاستدعاء ذلك المثيل مباشرة.
`TECHSTACK_API_TOKEN`	رمز Bearer المميز المُرسل مع كل طلب. بدونه يستخدم CLI الجلسة المخزنة بواسطة `techstack login`، ويفشل برمز الخروج 3 عندما لا توجد جلسة أو تكون قد انتهت صلاحيتها.

الخيارات العامة

الخيار	ينطبق على	الوصف
`--fields <paths>`	كل أمر	مسارات منقوطة مفصولة بفواصل للإبقاء عليها في الإخراج؛ وتُطبَّق على كل عنصر في المصفوفات.
`--ndjson`	كل أمر	طباعة المصفوفات كقيمة JSON مضغوطة واحدة في كل سطر.
`--dry-run`	الأوامر المعدِّلة	طباعة الطلب المحلول بصيغة JSON دون تفويضه أو إرساله.
`--idempotency-key <key>`	الأوامر المعدِّلة	ترويسة Idempotency-Key؛ والقيمة الافتراضية UUID جديد.
`--body <json\|@path\|->`	الأوامر ذات جسم JSON	جسم الطلب الأساسي كقيمة حرفية أو ملف أو stdin؛ وتتجاوز خيارات الوسائط خصائصه.
`--file <path\|->`	الأوامر ذات جسم ملف	ملف جسم الطلب المُرسل بنوع المحتوى المُعلَن.
`--yes`	الأوامر التي تتطلب تأكيداً	التأكيد دون مطالبة؛ مطلوب عند التشغيل غير التفاعلي.

الأوامر الموسومة بأنها تتطلب تأكيداً تطلب yes في الطرفية. وبدون طرفية ترفض إرسال الطلب ما لم يُضبط --yes، وتطبع الخطأ CONFIRMATION_REQUIRED وتخرج بالرمز 9.

رموز الخروج

الرمز	المعنى
0	نجاح.
1	أي فشل آخر.
2	إدخال غير صالح (HTTP 400/422).
3	غير مصادَق عليه (HTTP 401).
4	مرفوض أو يتطلب الدفع أو محدود المعدل (HTTP 402/403/429).
5	غير موجود (HTTP 404).
6	تعارض (HTTP 409).
7	فشل في الخادم أو النقل (HTTP 5xx).
9	التأكيد مطلوب أو مرفوض.

سياق الوكيل

يطبع techstack api agent-context كتالوج الأوامر هذا لوكلاء الذكاء الاصطناعي بصيغة Markdown، أو بصيغة JSON مع --json: كل أمر مع طريقة استخدامه ووسائطه وتأكيده وتوفره واسم أداة MCP الخاصة به، إضافة إلى الخيارات العامة ورموز الخروج أعلاه.

الأوامر

مجموعة الأوامر	يغطي
`techstack api addons`	الإضافات
`techstack api agents`	الوكلاء
`techstack api auth`	المصادقة
`techstack api autoinstall`	الحالة الصحية
`techstack api backups`	النسخ الاحتياطية
`techstack api client-pairing`	ربط العميل
`techstack api discovery`	الاكتشاف
`techstack api drift`	الـ Stacks - الانحراف
`techstack api features`	الميزات
`techstack api health`	الحالة الصحية
`techstack api homelab`	الـ Stacks
`techstack api install-scripts`	العمّال
`techstack api instance`	المثيل
`techstack api inventory`	الجرد
`techstack api jobs`	المهام
`techstack api managed-runtimes`	المهام، الـ Stacks
`techstack api monitor`	المقاييس
`techstack api monthly-runtimes`	المهام، وقت التشغيل الشهري، الـ Stacks
`techstack api pairing-tokens`	الثقة
`techstack api prechecks`	الفحوصات المسبقة
`techstack api runtime`	وقت التشغيل
`techstack api servers`	الجرد، المهام، RIL، الخوادم
`techstack api services`	المهام، الخدمات
`techstack api stack-identity`	المصادقة
`techstack api stackkits`	StackKits
`techstack api stacks`	الجرد، المهام، الـ Stacks، الـ Stacks - الانحراف، الـ Stacks - الاستيراد/التصدير، الـ Stacks - المواصفات
`techstack api system`	الحالة الصحية، المقاييس
`techstack api system-accounts`	المصادقة
`techstack api tunnel`	النفق
`techstack api unifier`	الموحِّد (Unifier)
`techstack api wallet`	المحفظة
`techstack api workers`	الفحوصات المسبقة، العمّال

مرجع API

مرجع Techstack API في هذا القسم مولَّد من مستند OpenAPI العام للإصدار نفسه.