Yaak - عميل API سطح المكتب
Yaak هو عميل API سطح مكتب حديث يركز على عدم الاتصال مبني بـ Tauri و Rust و React. يقوم بتنظيم وتنفيذ طلبات REST و GraphQL و gRPC و WebSocket و Server-Sent Events (SSE) في تطبيق سريع وخفيف الوزن يركز على الخصوصية: لا كشف عن البيانات ولا حساب مطلوب ولا حبس سحابي. مساحات العمل محفوظة كملفات عادية لذا يمكنك مزامنتها مع Git وتدعم البيئات والمتغيرات والاستيراد من Postman/Insomnia.
التثبيت
| النظام الأساسي | الطريقة |
|---|
| macOS | قم بتحميل .dmg من yaak.app أو brew install --cask yaak |
| Windows | قم بتحميل المثبت من yaak.app |
| Linux | AppImage / .deb / .rpm من yaak.app |
| التحقق | إطلاق التطبيق؛ تحقق من المساعدة → عن الإصدار |
أنواع الطلبات
| النوع | الاستخدام |
|---|
| REST / HTTP | طلبات API المعيارية |
| GraphQL | الاستعلامات/الطفرات مع استبصار المخطط |
| gRPC | استدعاء خدمات gRPC (مع الانعكاس) |
| WebSocket | اتصالات المقبس ثنائية الاتجاه |
| SSE | تدفقات Server-Sent Events |
المفاهيم الأساسية
| المصطلح | المعنى |
|---|
| مساحة العمل | تجميع المشروع للطلبات/البيئات |
| المجلد | تنظيم الطلبات داخل مساحة العمل |
| البيئة | مجموعة مسماة من المتغيرات (dev/staging/prod) |
| المتغير | ${[ name ]} نموذج مستخدم عبر الطلبات |
| مزامنة ملفات عادية | بيانات مساحة العمل محفوظة كملفات → صديق Git |
بناء الطلبات
| العنصر | ملاحظات |
|---|
| الطريقة + URL | مع نموذج متغير |
| معاملات الاستعلام | محرر قيمة مفتاح |
| الرؤوس | محرر قيمة مفتاح |
| الجسم | JSON و نموذج و GraphQL و ثنائي وغيره |
| المصادقة | Bearer و Basic و OAuth 2.0 و API key |
البيئات والمتغيرات
| الميزة | الاستخدام |
|---|
| البيئات | التبديل بين عناوين URL الأساسية/الأسرار حسب المرحلة |
| المتغيرات | المرجع مع ${[ var ]} في أي حقل |
| القيم الديناميكية | القيم المولدة (الطوابع الزمنية و UUIDs) |
| الأسرار | محفوظة خارج ملفات عادية متزامنة حيث تم تكوينها |
ميزات الإنتاجية
| الميزة | الوصف |
|---|
| مشاهد الرد | JSON جميل والرؤوس والوقت والحجم |
| السجل | الردود السابقة لكل طلب |
| الاستيراد | Postman و Insomnia و cURL و OpenAPI |
| الإضافات | التوسيع عبر نظام الإضافات |
| مزامنة Git | التزم ملفات مساحة العمل بمراقبة الإصدار |
| النماذج | طلبات السلسلة بالإشارة إلى الردود السابقة |
ملاحظات gRPC والحقائق |
| البروتوكول | الإمكانية |
|---|
| gRPC | انعكاس الخادم لاكتشاف الخدمات/الطرق؛ البث |
| GraphQL | استبصار المخطط وبناء الاستعلام والمتغيرات |
سير العمل الشائع
# سير عمل الفريق مع مزامنة قائمة على Git
1. إنشاء مساحة عمل؛ احفظها في ريبو الخاص بك
2. تحديد بيئات dev/staging/prod مع المتغيرات
3. بناء طلبات REST/GraphQL/gRPC باستخدام ${[ base_url ]}
4. التزم الملفات العادية؛ زملاء العمل يسحبون ويحصلون على نفس المجموعة
# طلبات السلسلة
- إرسال طلب تسجيل دخول وحد الرمز من الرد
- المرجع كمتغير في الطلبات المصرح بها اللاحقة
Yaak مقابل عملاء API الآخرين
| الجانب | Yaak | Postman | ATAC | Bruno |
|---|
| الواجهة | GUI سطح المكتب | GUI سطح المكتب | TUI المحطة الطرفية | GUI سطح المكتب |
| البروتوكولات | REST/GraphQL/gRPC/WS/SSE | واسع | REST | REST/GraphQL |
| كشف البيانات | لا شيء | نعم | لا شيء | لا شيء |
| التخزين | ملفات عادية (Git) | سحابة/محلي | ملفات | ملفات (Git) |
| الأفضل لـ | GUI يركز على الخصوصية و متعدد البروتوكول | الفرق/السحابة | أول المحطة الطرفية | GUI + Git |
موارد
