خدمة Kitالطرفية
صدفة Linux مستمرة مكشوفة كنقطة نهاية HTTPS. شغّل الأوامر عبر API، اتصل من أي متصفح، أو بثّ المخرجات عبر WebSocket.
# Get your token
$ curl -X POST \
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/execute \
-H "Authorization: Bearer $TOKEN" \
-d '{"command":"echo Hello from Hoody!"}'
> { "command_id": "42", "status": "running" }
# Run your first command
$ curl \
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/result/42 \
-H "Authorization: Bearer $TOKEN"
> { "status": "completed", "output": "Hello from Hoody!", "exit_code": 0 }
# Share the URL — anyone can connect
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com
الـ URL هو الواجهة
لكل terminal عنوان واحد متوقَّع. اقرأه من اليسار إلى اليمين لتعرف تمامًا أي خدمة وأي instance وأي container تخاطب.
https://abc123-def456-terminal-1.node-us-1.containers.hoody.comabc123المشروع
معرّف مشروعك.
def456Container
معرّف الـ container.
terminalالخدمة
أي خدمة من Kit — terminal أو files أو display…
1Instance
شغِّل عدّة: terminal-1، terminal-2، terminal-3.
node-us-1الخادم
العقدة التي يعمل عليها الـ container.
الـ URL هو الواجهة. بلا منافذ، بلا إعدادات، بلا تهيئة شبكة.
كل أمر هو استدعاء API
التنفيذ غير متزامن. أطلِق أمرًا، استلم ID، ثم اقرأ النتيجة — أو تابِعها مباشرة عبر WebSocket.
أرسل أمرًا عبر POST. تحصل فورًا على command_id وحالة: running.
استعلِم endpoint النتيجة للحصول على المخرجات المجمَّعة ورمز الخروج.
افتح WebSocket لإطارات terminal لحظة حدوثها.
كل شيء مدمج
كل ميزة متاحة بلا ضبط. الطرفية جاهزة للاستخدام فور تشغيل حاويتك.
terminal كامل داخل الـ browser
افتح الـ URL على أي جهاز — هاتف أو جهاز لوحي أو laptop. اضبط واجهة الويب بالكامل عبر query parameters: الـ shell وحجم الخط ووضع القراءة فقط والعنوان واللوحات الجانبية.
?shell=zsh?fontSize=16?readonly=true?title=Prod?panel=/docsاختيار الصدفة
bash، zsh، fish، tmux، sh — بدّل الصدفات عبر معامل URL. مثبتة ومستعدة.
API الأتمتة
أرسل ضغطات المفاتيح، الصِق النص، وانتظر استقرار الشاشة — تحكّم في البرامج التفاعلية عبر HTTP.
لقطات الطرفية
التقط حالة الطرفية كـ PNG أو JPEG أو GIF عبر API. ألوان وحجم خط قابلة للضبط للتوثيق.
حالة الجلسة المباشرة
يُحفظ مجلد العمل والـ shell والسجل طوال بقاء الجلسة، ويصمد بعد إعادة الاتصال.
SSH إلى أي خادم
افتح جلسة كاتصال SSH بعيد — المضيف والمستخدم والمفتاح كمعاملات.
19 نقطة نهاية، تحكم كامل
أربعة مجالات: تنفيذ الأوامر، إدارة الجلسات، البث الحي عبر WebSocket، ومراقبة النظام.
تنفيذ الأوامر
5 endpointscurl -X POST .../terminal/execute -d '{"command":"npm test"}'
إدارة الجلسات
6 endpointscurl .../terminal/sessions → [{ "terminal_id": "1", "shell": "bash" }]
البث الحي
4 endpointsWS .../terminal/ws — real-time terminal frames
النظام والبيانات الوصفية
7 endpointscurl .../system/resources → { "cpu": 45.2, "memory": { ... } }
مبني لسير العمل الحقيقية
الطرفية تغطي النطاق الكامل لسيناريوهات المطور والأتمتة.
- 01
التطوير عن بُعد
GET /terminal/wsادخل إلى حاويتك عبر SSH من أي جهاز بمتصفح. وصول كامل للصدفة مع جلسات مستمرة — واصل من حيث توقفت.
- 02
تنسيق وكيل الذكاء الاصطناعي
POST /terminal/executeالوكلاء ينفّذون أوامر الصدفة عبر HTTP API. بناء، اختبار، نشر — Terminal API يمنح وكلاء الذكاء الاصطناعي وصولاً منظماً.
- 03
تصحيح أخطاء الفريق
GET /terminal/sessionsشارك عنوان URL للطرفية مع فريقك لتصحيح الأخطاء متعدد اللاعبين. الجميع يرى نفس المخرجات ويمكنه الكتابة.
- 04
التطبيقات الرسومية
?display=Nشغّل أي تطبيق رسومي من الطرفية. Firefox، VS Code، GIMP — terminal-N يربط تلقائياً بـ display-N.
- 05
تكامل CI/CD
GET /terminal/result/{id}شغّل خطوات البناء، نفّذ الاختبارات، انشر المنتجات — كل ذلك عبر HTTP. ادمج الطرفية في أي خط أنابيب CI.
- 06
المراقبة الحية
GET /system/resourcesإحصائيات CPU والذاكرة والقرص والشبكة الفورية عبر API. سرد العمليات الجارية، إرسال الإشارات، فحص المنافذ.
مستعد للاستكشاف؟
الطرفية هي واحدة من 18 خدمة Kit تأتي مع كل حاوية Hoody. بلا تثبيت، بلا ضبط — استكشفها فوراً.