البدء

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

لا يحتاج Getman إلى حساب ولا إلى خادم ولا إلى اشتراك. العبارة الظاهرة في شاشة الترحيب هي No account, no sync, no telemetry، وهي صحيحة: تبقى كل البيانات على جهازك حتى تختار أن تنفذ commit أو push أو تكتب إلى مجلد.

ما الذي تحتاجه

• Getman 0.1.2 أو أحدث على macOS 10.13 أو أحدث، أو على Windows 10 أو 11 (x64) مع WebView2.
• Git، إذا أردت مشاركة المشروع عبر مستودع.
• Node.js 20 أو أحدث، فقط إذا أردت سطر الأوامر أو وكيلا برمجيا.

أول طلب لك

1. افتح Getman واختر New project… من قائمة شريط العنوان، أو Start an empty project من شاشة الترحيب.
2. سمِّ المشروع. ينشئ Getman المشروع ويفتح مساحة عمل الطلبات.
3. اختر New request (⌘N على macOS، وCtrl+N على غيرها)، وأدخل عنوانا مثل https://httpbin.org/get.
4. اضغط Send أو ⌘↵.

تعرض لوحة الاستجابة الحالة والترويسات والمحتوى. لا تحتاج إلى أي شيء آخر لتجربة التطبيق.

إعداد مشروع حقيقي

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

1. افتح Environments من الشريط الجانبي، وأضف بيئة لواجهة API المحلية.
2. أضف متغيرا مثل base_url ووجّهه إلى خادمك.
3. استخدم المتغير في عنوان الطلب: {{base_url}}/orders/:id.
4. اختر البيئة من قائمة البيئات في أعلى اليمين. يعرض شريط الحالة المضيف الذي تستهدفه.

تُخفى القيم السرية، مثل كلمات المرور والرموز، ولا تُكتب أبدا في ملف يراه Git. يشرح الطلبات والمصادقة كيفية استخدامها.

إلى أين تذهب بعد ذلك

• يغطي التثبيت تطبيق سطح المكتب وسطر الأوامر ومساحة عمل الفريق.
• يغطي الطلبات أجسام الطلبات والألسنة وتوليد الشيفرة.
• يوضح سير عمل الفريق كيف يصل تغيير في الخادم إلى فريق الويب على شكل حزمة تغيير.
• تسرد استكشاف الأخطاء الأخطاء الشائعة وحلولها.

إذا كنت تفضل المشاهدة أولا، فالفصل الأول من فيديو التأهيل يغطي تثبيت Getman وفتح مساحة عمل الفريق.