Getman
Englishالتنزيل

تغييرات API تصلك مُختبَرة.

Getman تطبيق سطح مكتب لواجهات API يعمل بالكامل على جهازك. ابنِ الطلبات واختبرها، ثم سلّم كل تغيير في الـ API لفريق الواجهة الأمامية ووكلاء البرمجة لديهم، عبر مستودع Git الذي تستخدمه بالفعل.

نزّل Getmanشاهد الشرح

تطبيق سطح مكتب لـ macOS وWindows. بلا حساب وبلا اشتراك.

نافذة Getman: طلب GET محفوظ إلى Shop API مع استجابة JSON بحالة 200 OK، ومدتها وحجمها.
البناء والاختبار

عميل الـ API الذي تعرفه، بلا سحابة.

الطلبات والمجموعات والبيئات محفوظة على جهازك. كل ما تحتاجه لعملك اليومي مع واجهات API موجود منذ أول تشغيل.

  1. كل أنواع الطلبات

    طلبات REST بمحتوى JSON أو نموذج أو multipart أو XML أو ملف ثنائي أو GraphQL، إضافة إلى WebSocket وServer-Sent Events، من منشئ طلبات واحد.

  2. مصادقة تضبطها مرة واحدة

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

  3. بيئات تخبرك أين أنت

    محلية وتطوير واختبار وإنتاج، تبدّل بينها من شريط العنوان. والطلب الذي قد يعدّل البيانات على خادم إنتاج يطلب تأكيدك قبل إرساله.

  4. تحققات بلا كود

    تحقّق من الحالة وزمن الاستجابة وحقول JSON والترويسات وأطوال المصفوفات أو من JSON Schema. واستخرج القيم إلى متغيرات للطلب التالي.

  5. شغّل مجموعة كاملة

    شغّل المجلدات أو المجموعات بالترتيب، وانقل القيم المستخرجة من خطوة إلى أخرى، وشاهد كل تحقّق نجح أو فشل.

  6. سكربتات داخل بيئة معزولة

    سكربتات ما قبل الطلب والاختبار تعمل في بيئة QuickJS معزولة، بحدود للذاكرة والوقت.

أبعد من تطبيق سطح المكتب

المحرك نفسه في الطرفية وفي CI ولدى وكيلك.

الأمر getman يشغّل الطلبات المحفوظة بالمحرك نفسه الذي يستخدمه التطبيق. وخادم MCP محلي يمنح وكلاء البرمجة القدرات نفسها، ضمن حدود تضعها أنت.

واجهة سطر أوامر للسكربتات وCI
شغّل طلبًا أو مجلدًا أو مجموعة مع أي بيئة. مخرجات مقروءة لك، وJSON لخطوط التكامل، ورموز خروج يمكن لـ CI الاعتماد عليها. اقرأ التوثيق
خادم MCP محلي لوكلاء البرمجة
يستطيع Claude Code وغيره من عملاء MCP عرض الطلبات وقراءة العقد وتشغيل الطلبات وإنشاء حزم التغيير. تبقى الأسرار في بيئتك، وتُحذف من كل إجابة. اقرأ التوثيق
بيئة الإنتاج تبقى محميّة
أي طلب POST أو PUT أو PATCH أو DELETE يرسله وكيل إلى بيئة إنتاج يحتاج موافقتك، طلبًا بعد طلب. والخيار --read-only يزيل كل أدوات الكتابة.
$ getman run "Shop API" --workspace getman --env Local
Running Shop API · project Shop · env Local
  ✓ POST    http://127.0.0.1:4321/auth/login  200 OK  654 ms  67 B
      ✓ Status is 200
      ✓ accessToken exists
  ✓ GET     http://127.0.0.1:4321/products  200 OK  3 ms  111 B
      ✓ Status is 200
      ✓ $ length is at least 1
  ✓ GET     http://127.0.0.1:4321/orders/o1  200 OK  10 ms  104 B
      ✓ Status is 200
      ✓ total exists
      ✓ Response time is under 1000 ms
3 requests: 3 passed · 0 failed · 0 errors · 0 skipped · 670 ms (exit 0)
التعاون عبر Git

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

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

  1. مطوّر الخلفية
  2. Getman
  3. Git
  4. مطوّر الواجهة
  5. وكيل البرمجة

  1. في Shop API، تعيد أليس تسمية الحقل total إلى totalCents وتضيف currency إلى GET /orders/{id}، ثم تحدّث الطلب المحفوظ في Getman.

  2. يقارن Getman عقد OpenAPI 3.1 بالنسخة السابقة. الحقول الجديدة تغيير غير كاسر. أما حذف total فيُصنَّف «قد يكون كاسرًا»، لأن مخطط تلك الاستجابة استُنتج من الأمثلة، وهو دليل ضعيف.

  3. من Changes ثم New change package. تسجّل الحزمة نقطة النهاية وفروق العقد والأمثلة وملاحظة الترحيل: اقرأ totalCents (بالسنتات) وcurrency؛ الحقل total لم يعد موجودًا. ومرجعها GT-SHOP-001.

  4. الزر Verify now يشغّل الطلبات المتأثرة على الـ API العامل، وتُسجَّل النتيجة في الحزمة. لا أحد يكتب «نجح» بيده.

  5. تودِع أليس الكود ومجلد getman/‎ معًا في commit واحد ثم تدفعه. لا يوجد خادم لـ Getman في الطريق.

  6. يضغط بوب Fetch، فيقرأ Getman الـ commits الواردة ويعرض الحزمة قبل أن يسحبها.

  7. بما أن I integrate as مضبوط على web، تصل الحزمة إلى صندوق بوب مع درجة خطورتها ودليل التحقق.

  8. يعطي بوب وكيل البرمجة المرجع فقط. عبر MCP يستدعي الوكيل list_changes ثم get_change ويقرأ الفروق والأمثلة.

  9. يحدّث الوكيل عميل الويب واختباراته في مستودع بوب، مستعينًا بأمثلة الحزمة.

  10. الأداة report_integration تشغّل الطلبات أولًا، ولا تقبل الحالة verified إلا بتشغيل ناجح على العقد الحالي. وبعد السحب، ترى أليس Integration verified.

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

صمّم واجهات API وافهمها

عقود تقرؤها وتقارنها وتحاكيها.

صدّر عقد OpenAPI 3.1 من طلباتك، واعرف بالضبط ما الذي تغيّر بين نسختين، وقدّم الأمثلة محليًا قبل أن تجهز الخلفية.

كشف التغييرات الكاسرة

مقارنة العقود تصنّف كل تغيير: كاسر، أو قد يكون كاسرًا، أو غير كاسر، أو غير معروف، لكلٍّ من الطلبات والاستجابات على حدة.

محرر OpenAPI

مخطط ونماذج ومحرر JSON أو YAML خام، مع التحقق والاستيراد والتصدير.

خادم محاكاة محلي

قدّم الأمثلة المحفوظة أو ملف OpenAPI على 127.0.0.1، مع الحالة والترويسات والتأخير وسجل الطلبات.

استيراد HAR وPostman

استورد ملفات HAR ومجموعات Postman وبيئاته وOpenAPI 3 أو Swagger 2، أو الصق أمر cURL.

  • Postman v2.1
  • OpenAPI 3
  • Swagger 2
  • HAR 1.2
  • cURL

كود Fetch وAxios

ولّد كود العميل مع المصادقة والترويسات الموروثة، والأسرار مخفية.

اعرف المزيد: المزايا

محلي أولًا، بالتصميم

جهازك. مستودعك. لا شيء بينهما.

لا حساب في Getman، ولا خدمة مزامنة، ولا جمع لبيانات الاستخدام. يتعاون الفريق عبر استضافة Git التي يستخدمها بالفعل.

في مستودع Git

  • getman.yamlمصادقة المشروع وترويساته، بلا أسرار
  • environments/*.yamlأسماء المتغيرات، وقيم الأسرار فارغة
  • collections/**.yamlملف لكل طلب
  • contracts/openapi.yamlالعقد الحالي
  • changes/GT-…yamlحزم التغيير مع الأدلة والحالة

على جهازك فقط

  • قيم الأسرار، مشفّرة بـ AES-256-GCM
  • مفتاح التشفير، في سلسلة مفاتيح النظام
  • السجل وملفات تعريف الارتباط والاستجابات
  • قاعدة بيانات التطبيق، في مجلد بيانات المستخدم

يحصل الوكلاء على الأسرار من GETMAN_VAR_<KEY> في الطرفية التي تشغّلهم، ولا يرونها أبدًا في مخرجات الأدوات.

الأمان والخصوصية
الشرح

تعلّم Getman من البداية إلى النهاية.

جولة مشروحة بالصوت: التثبيت، والعمل اليومي مع واجهات API، وما يحفظه Getman في Git، وربط وكيل برمجة، وتغيير حقيقي من الخلفية إلى الواجهة.

شرح البدء مع Getman

المدة: التعليق الصوتي بصوت نظام macOS.التشغيل يحمّل YouTube، الذي يضع ملفات تعريف الارتباط الخاصة به.

اقرأ النص الكاملالترجمة (WebVTT)اقرأ الدليل المكتوب

الفصول

ابدأ وحدك

  1. نزّل Getman
  2. افتح مشروعًا أو استورد مجموعة
  3. أرسل طلبك الأول
البدء

أحضِر فريقك

  1. اربط مجلد getman/‎ في مستودعك
  2. اربط وكيل البرمجة عبر MCP
  3. شارك أول حزمة تغيير
عمل الفريق

أسئلة وإجاباتها

ما هو Getman؟

تطبيق سطح مكتب لواجهات API على macOS وWindows. تبني الطلبات وتختبرها وتوثّقها كما في Postman، وتسلّم تغييرات الـ API للمطوّرين الآخرين ووكلاء البرمجة لديهم عبر Git، في صورة حزم تغيير مع أدلة اختبار حقيقية.

هل Getman مجاني؟

لا سعر لـ Getman ولا اشتراك ولا حساب. تنزّله وتستخدمه.

هل أحتاج إلى حساب؟

لا. لا يوجد حساب أو خادم لـ Getman. بياناتك تبقى على جهازك، ويتشارك الفريق عبر مستودع Git الخاص به.

هل يعمل دون اتصال بالإنترنت؟

نعم. يحتاج Getman الشبكة فقط للوصول إلى واجهات API التي تستدعيها، ولمستودع Git البعيد إن كنت تستخدمه.

هل يستطيع فريقي استخدام Git؟

نعم، وهكذا يعمل الفريق معًا في Getman. اربط مجلد getman/ في مستودعك. يستخدم Getman نسخة Git المثبّتة لديك بمفاتيح SSH وبيانات الدخول الخاصة بك، ولا يُنشئ commit أو يدفع أو يدمج من تلقاء نفسه.

هل يحتاج MCP إلى مفتاح API لخدمة ذكاء اصطناعي؟

لا. خادم MCP في Getman يعمل محليًا ولا يستدعي أي خدمة ذكاء اصطناعي. وكيل البرمجة (مثل Claude Code) يستخدم حسابه الخاص، وGetman يجيب فقط عن استدعاءات الأدوات.

كيف أربط Claude Code؟

ثبّت أداة سطر الأوامر من التطبيق، وأودِع ملف .mcp.json يشغّل getman mcp --workspace getman، وصدّر الأسرار التي تحتاجها الطلبات بالصيغة GETMAN_VAR_<KEY>، ثم شغّل claude من جذر المستودع.

هل يدعم Getman نظامَي macOS وWindows؟

نعم. على macOS تطبيق شامل يعمل على معالجات Apple وIntel. أما ملفات تثبيت Windows فتبنيها منظومة CI، لكنها لم تُختبر على جهاز Windows حقيقي بعد.

كيف تُعامَل الأسرار؟

تُشفَّر قيم الأسرار بـ AES-256-GCM، والمفتاح في سلسلة مفاتيح النظام. تُكتب في Git فارغة، ولا تُصدَّر أبدًا، وتظهر مخفية على الشاشة، وتُحذف من مخرجات سطر الأوامر وMCP.

كيف أحدّث التطبيق؟

نزّل الإصدار الجديد وثبّته فوق القديم. لا يحدّث Getman نفسه بعد.

كيف يقارَن بـ Postman أو Apidog؟

العمل اليومي على الطلبات متشابه. لكن Getman محلي أولًا: لا حساب ولا مساحة عمل سحابية. ويضيف حزم التغيير وفروق العقود وأدلة التحقق وخادم MCP، لتصل تغييرات الـ API إلى الواجهة الأمامية ووكلائها عبر Git. ويستورد مجموعات Postman وبيئاته، وملفات OpenAPI من أي أداة.

ما هي حزمة التغيير؟

ملف YAML في مستودعك يصف تغييرًا واحدًا في الـ API: نقاط النهاية المتأثرة، وفروق العقد ودرجة خطورتها، والأمثلة، وملاحظات الترحيل، وأدلة من تشغيلات اختبار حقيقية، وحالة التكامل لدى كل مستهلك. ولها مرجع مثل GT-SHOP-001 يستخدمه الأشخاص والوكلاء.

أرسل طلبك الأول.

مجاني الاستخدام، ولا شيء لتسجّل فيه. طلباتك تبقى على جهازك.

نزّل Getman

تطبيق سطح مكتب لـ macOS وWindows. بلا حساب وبلا اشتراك.