resterm v1.5.6
عميل API للطرفية (Terminal) يدعم HTTP وGraphQL وgRPC. ملفات .http بسيطة يمكنك مقارنتها والتحكم بإصداراتها، مع سير عمل، نماذج محاكاة، تنميط، تتبّع، استيراد OpenAPI، أنفاق SSH، إعادة توجيه منافذ Kubernetes، WebSocket وSSE ومشغّل CLI.
Resterm
منصة عمل API-as-code للطرفية.
resterm.app · docs
Resterm هو عميل API يستخدم ملفات .http/.rest كشيفرة مصدرية. تعيش جميع الميزات تقريبًا في ملفات .http، لذا يسهل مراجعتها في Git أو أي نظام تحكم بالإصدارات آخر. يمكنك إرسال الطلبات، واختبار تدفقات API، وتسجيل حركة HTTP، وتشغيل خوادم محاكاة محلية مباشرة من TUI أو تشغيل نفس التعريفات في السكربتات و CI باستخدام أمر resterm run.
لماذا Resterm
- اختبر تدفقات API كاملة. سجّل الدخول، والتقط رمزًا، وأنشئ موردًا، وتحقق من النتيجة. أضف التأكيدات والحلقات والشروط وإعادة المحاولات والسكربتات مباشرة في ملفات الطلبات.
- حوّل حركة المرور الحقيقية إلى محاكاة محلية. سجّل طلبات HTTP واستجاباتها، ثم احفظها كطلبات قابلة للتشغيل أو تعريفات محاكاة. احتفظ بالمحاكاة بجانب الطلبات التي تستخدمها.
- اكتشف ما الذي تغيّر. قارن الاستجابات عبر البيئات، وقارنها بالنتائج السابقة، وافحص توقيتات الطلبات، وحلّل التشغيلات المتكررة.
- شغّل نفس الفحوصات محليًا وفي CI. استخدم واجهة الطرفية أثناء التطوير، ثم شغّل تلك الملفات باستخدام
resterm run. صدّر تقارير JSON أو JUnit. - اعمل عبر بروتوكولات متعددة. أرسل طلبات HTTP و GraphQL و gRPC، وتعامل مع تدفقات WebSocket و SSE.
تتيح لك أنفاق SSH المدمجة وتحويلات منافذ Kubernetes الوصول إلى واجهات API خلف نقطة عبور أو داخل عنقود.
لا حساب، لا قياس عن بُعد، لا ميزات ذكاء اصطناعي.
لقطات الشاشة
التتبع والخط الزمني
انقر لرؤية المزيد من الواجهة
سير العمل
المحلّل
الشرح
RestermScript
التثبيت
macOS و Linux:
brew install resterm
# or
curl -fsSL https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.sh | bash
Windows:
iwr -useb https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.ps1 | iex
مع Go 1.25 أو أحدث:
go install github.com/unkn0wn-root/resterm/cmd/resterm@latest
تتوفر ملفات ثنائية جاهزة لـ macOS و Linux و Windows على صفحة الإصدارات. تحتاج ملفات Linux الثنائية إلى glibc 2.32 أو أحدث.
للتحديث، شغّل brew upgrade resterm إذا ثبّت باستخدام Homebrew. وإلا شغّل resterm --update. المزيد في دليل التثبيت.
البدء السريع
mkdir my-api && cd my-api
resterm init
resterm
ينشئ resterm init ملف requests.http مع بعض الطلبات النموذجية ومحاكاة محلية للرد عليها، لذا لا تحتاج إلى API حقيقي لتجربته. اضغط g Shift+M لبدء خادم المحاكاة، وحرّك المؤشر إلى طلب واضغط Ctrl+Enter لإرساله. اضغط ? للمساعدة في أي وقت.
لا تحتاج إلى init أيضًا. شغّل resterm، واكتب عنوان URL أو الصق أمر curl، واضغط Ctrl+Enter.
يعمل الملف نفسه أيضًا بدون الواجهة. ابدأ المحاكاة في طرفية واحدة وشغّل طلبًا في أخرى:
resterm mock requests.http # terminal 1
resterm run --request CreateUser requests.http # terminal 2
ملفات الطلبات
يقرأ Resterm تنسيق .http القياسي ويضيف توجيهات # @ فوقه للإعدادات والأتمتة:
# @setting base-url https://api.example.com/v1/
### Create users
// Send this request once for each name in the list.
# @for-each ["david", "tom"] as name
# @when env.mode == "development"
# @assert response.statusCode == 201
POST users
Content-Type: application/json
{"name":"{{= name }}"}
ينطبق @setting قبل الطلب الأول على الملف بأكمله. يبدأ ### طلبًا جديدًا. يمكن للتوجيهات فوق الطلب أن تكرره أو تتخطاه أو تتحقق من الاستجابة.
هناك المزيد من الأمثلة في _examples/، وكل توجيه مُدرج في مرجع ملف الطلبات.
التوثيق
التوثيق الكامل على resterm.app/docs. من الأماكن الجيدة للبدء سير العمل وخوادم المحاكاة والتسجيل وواجهة سطر الأوامر وRestermScript.
داخل TUI، يفتح :help <topic> الدليل المدمج ويفتح :docs <topic> الصفحة نفسها على الموقع.
لتشغيل ملفات الطلبات من شيفرة Go الخاصة بك، راجع حزمة headless.
الرعاية
Resterm مجاني ومفتوح المصدر وسيبقى كذلك دائمًا. إذا أعجبك عملي، يمكنك رعايته على GitHub.