المزايا

ما يفعله Getman اليوم. كل ما في هذه الصفحة موجود في النسخة الحالية.

الطلبات

طلبات REST بمحتوى JSON أو نص أو XML أو نموذج أو multipart (حقول نصية وملفات) أو ملف ثنائي أو GraphQL
WebSocket (استقبال الإطارات النصية والثنائية) وServer-Sent Events
معاملات المسار والاستعلام والترويسات وملفات تعريف الارتباط
عنوان وسيط (proxy) وشهادة CA مخصّصة
سجل الطلبات وأمثلة الاستجابات وعرض توثيق الـ API

المجموعات والبيئات

مشاريع ومجموعات ومجلدات مع ترتيب بالسحب والإفلات
أنواع البيئات: محلية وتطوير واختبار وإنتاج وأخرى
متغيرات بأولوية واضحة: وقت التشغيل ثم البيئة ثم المجموعة ثم المشروع ثم العام
متغيرات سرية، مخفية على الشاشة ومشفّرة عند الحفظ
تأكيد قبل أن يصل طلب قد يعدّل البيانات إلى بيئة الإنتاج

المصادقة

Bearer وBasic ومفتاح API (في الترويسة أو الاستعلام) وملفات تعريف الارتباط وترويسات مخصّصة
OAuth 2.0: بيانات اعتماد العميل، وكلمة المرور، ورمز التفويض مع PKCE، ورمز التحديث
تُضبط مرة واحدة على المشروع، وترثها المجموعات والمجلدات والطلبات أو تتجاوزها

الاختبار

تحققات بلا كود: الحالة، وزمن الاستجابة، ووجود حقل JSON أو قيمته أو طوله، والترويسة، واحتواء المحتوى، وJSON Schema
مستخرجات من المحتوى أو الترويسة أو ملف تعريف الارتباط أو الحالة إلى متغيرات وقت التشغيل أو البيئة أو المجموعة أو العامة
سكربتات ما قبل الطلب والاختبار في بيئة QuickJS معزولة (ذاكرة 32 ميجابايت، ومهلة افتراضية 5 ثوانٍ)
مشغّل مجموعات مع التكرارات والتأخير وملفات البيانات ونتائج كل خطوة

العقود والتصميم

تصدير OpenAPI 3.1 من طلباتك المحفوظة
مقارنة العقود مع تصنيف: كاسر، قد يكون كاسرًا، غير كاسر، غير معروف
محرر OpenAPI: مخطط ونماذج وJSON أو YAML خام وتحقق
خادم محاكاة محلي من الأمثلة المحفوظة أو ملف OpenAPI
استيراد مجموعات Postman v2.1 وبيئاته وOpenAPI 3 وSwagger 2 وHAR 1.2 وcURL
التصدير إلى Postman v2.1 أو OpenAPI 3.1 أو مساحة عمل Getman
توليد الكود: Fetch وAxios وcURL

الفريق وGit

مجلد getman/‎ في مستودعك الحالي: ملف YAML لكل طلب
Fetch وPull (تقديم سريع فقط) وCommit وPush من داخل التطبيق، باستخدام Git المثبّت لديك
رفض علامات التعارض والملفات غير الصالحة عند التحميل
حزم تغيير الـ API مع فروق العقد والأمثلة وملاحظات الترحيل والأدلة
صندوق التكامل وقائمة المكتمل والخط الزمني
سبع تسميات للتحقق، من Not tested حتى Integration verified

سطر الأوامر والوكلاء

getman run للطلبات والمجلدات والمجموعات، مع مخرجات JSON ورموز خروج لـ CI
getman contract export وdiff --fail-on breaking
getman change new وlist وshow وverify وreport وvalidate
getman mock لتقديم الأمثلة من الطرفية
getman mcp: خادم MCP محلي بـ 11 أداة قراءة و4 أدوات كتابة
موافقة على كل طلب كتابة يرسله وكيل إلى الإنتاج
وضع ‎--read-only وحصر مساحة العمل

التعاون عبر Git

تغيير واحد في الـ API، من الخلفية إلى الواجهة.

حزمة التغيير تنتقل مع الكود، عبر مستودع Git الذي يستخدمه فريقك بالفعل. تابع عملية تسليم حقيقية خطوة بخطوة.

مطوّر الخلفية
Getman
Git
مطوّر الواجهة
وكيل البرمجة

في Shop API، تعيد أليس تسمية الحقل total إلى totalCents وتضيف currency إلى GET /orders/{id}، ثم تحدّث الطلب المحفوظ في Getman.
يقارن Getman عقد OpenAPI 3.1 بالنسخة السابقة. الحقول الجديدة تغيير غير كاسر. أما حذف total فيُصنَّف «قد يكون كاسرًا»، لأن مخطط تلك الاستجابة استُنتج من الأمثلة، وهو دليل ضعيف.
من Changes ثم New change package. تسجّل الحزمة نقطة النهاية وفروق العقد والأمثلة وملاحظة الترحيل: اقرأ totalCents (بالسنتات) وcurrency؛ الحقل total لم يعد موجودًا. ومرجعها GT-SHOP-001.
الزر Verify now يشغّل الطلبات المتأثرة على الـ API العامل، وتُسجَّل النتيجة في الحزمة. لا أحد يكتب «نجح» بيده.
تودِع أليس الكود ومجلد getman/‎ معًا في commit واحد ثم تدفعه. لا يوجد خادم لـ Getman في الطريق.
يضغط بوب Fetch، فيقرأ Getman الـ commits الواردة ويعرض الحزمة قبل أن يسحبها.
بما أن I integrate as مضبوط على web، تصل الحزمة إلى صندوق بوب مع درجة خطورتها ودليل التحقق.
يعطي بوب وكيل البرمجة المرجع فقط. عبر MCP يستدعي الوكيل list_changes ثم get_change ويقرأ الفروق والأمثلة.
يحدّث الوكيل عميل الويب واختباراته في مستودع بوب، مستعينًا بأمثلة الحزمة.
الأداة report_integration تشغّل الطلبات أولًا، ولا تقبل الحالة verified إلا بتشغيل ناجح على العقد الحالي. وبعد السحب، ترى أليس Integration verified.

shop/backend/server.mjs

-  o1: { id: "o1", status: "paid", total: 4800, items: [ … ] },
+  o1: { id: "o1", status: "paid", totalCents: 4800, currency: "USD", items: [ … ] },

Compare contracts · GET /orders/{id}

Potentially breaking property total removed schema inferred from examples: weak evidence
Non-breaking property totalCents added …schema.totalCents
Non-breaking property currency added …schema.currency

changes/GT-SHOP-001.yaml

GT-SHOP-001 draftPotentially breaking

Order totals in cents, with currency

GET /orders/{id} returns totalCents and currency instead of total.

Migration Read totalCents (integer cents) and currency; total is gone.

Verify now · env Local

✓ POST /auth/login       200 OK
✓ GET  /products         200 OK
✓ GET  /orders/o1        200 OK  totalCents exists
Evidence recorded: Tests passed 3/3

Alice's terminal

$ git add backend getman
$ git commit -m "Order totals in cents (GT-SHOP-001)"
$ git push
To origin  main -> main

Bob's Getman · Git bar

main1 incoming commitFetchPull

Fetched. 1 incoming change package: GT-SHOP-001 (Not pulled)

Changes · Inbox · I integrate as web

GT-SHOP-001Potentially breakingFor youOrder totals in cents, with currencyTests passed

Coding agent · MCP

→ list_changes { consumer: "web" }
  GT-SHOP-001  potentially-breaking  Tests passed
→ get_change { id: "GT-SHOP-001" }
  diff, examples, migration, evidence

web/src/api/orders.mjs

 * @typedef {{ id, status,
-   total: number, items }} Order
+   totalCents: number, currency: string, items }} Order
-  return `$${(order.total / 100).toFixed(2)}`;
+  return `$${(order.totalCents / 100).toFixed(2)} ${order.currency}`;

GT-SHOP-001 · Integrations

web Integration verified passing run against the current contract

After Fetch and Pull, Alice sees Integration verified.

كل ما سبق يجري على جهازَي حاسوب ومستودع Git بعيد واحد. لا توجد خدمة سحابية لـ Getman.

نظرة أقرب

منشئ الطلبات مع استجابة JSON
المجموعات والمجلدات
البيئات والمتغيرات
التحققات بعد الإرسال
نتائج مشغّل المجموعات
مقارنة العقود
حزمة تغيير
صندوق التكامل
محرر OpenAPI
خادم المحاكاة المحلي
توليد الكود
تأكيد قبل الكتابة إلى الإنتاج
لوحة الأوامر
المصادقة الموروثة

اختصارات لوحة المفاتيح

المفتاح Mod هو ⌘ على macOS وCtrl على Windows.

لوحة الأوامر	`⌘KCtrlK`
ابحث عن طلب	`⌘PCtrlP`
أرسل الطلب	`⌘↩CtrlEnter`
ألغِ الطلب	`⌘.Ctrl.`
احفظ	`⌘SCtrlS`
طلب جديد	`⌘NCtrlN`
استيراد	`⌘OCtrlO`
انتقل إلى حقل العنوان	`⌘LCtrlL`
عرض Changes	`⌘⇧GCtrlShiftG`
انسخ كأمر cURL	`⌘⇧CCtrlShiftC`
بدّل تقسيم الاستجابة	`⌘⇧LCtrlShiftL`
أظهر الشريط الجانبي أو أخفه	`⌘BCtrlB`

كل اختصارات لوحة المفاتيح

ليس في Getman اليوم

مخطط له أو مؤجَّل عن قصد. لا شيء من هذا متاح الآن.

خادم فريق مباشر للتعاون اللحظي (اليوم، يتشارك الفريق عبر Git)
مزامنة سحابية وحسابات وتسجيل دخول موحّد
مزايا ذكاء اصطناعي داخل التطبيق بمفتاحك الخاص
التقاط حركة الشبكة عبر وسيط (proxy)
ملفات تثبيت موقّعة وموثّقة
التحديث التلقائي