Roqueman API Client
Roqueman هو عميل API الخاص بـ RoqueOS — أشبه بـ Postman/Insomnia يعمل داخل سطح مكتبك على الويب. أنشئ وأرسل طلبات HTTP وWebSocket وGraphQL، ونظّم كل شيء في مجموعات، واستخدم المتغيرات والبيئات، واكتب سكربتات اختبار، وأتمت التدفقات عبر تسلسل الاستجابات ومُشغّل المجموعات — دون تثبيت أي شيء.
لماذا هذا مفيد
تختبر واجهات API في نفس المكان الذي تعمل فيه بالفعل، مع مزامنة البيانات في حسابك. لا تطبيق منفصل ولا تسجيل دخول إضافي — افتح Roqueman من Launchpad وابدأ.
للمسؤولين: مجموعة الخادم تلقائيًا
يحصل المسؤولون المتصلون بخادم تلقائيًا على مجموعة RoqueOS Server (جميع نقاط نهاية واجهة برمجة تطبيقات الخادم) مع بيئة تشير إلى الخادم النشط — جاهزة للتشغيل.
أوضاع التنفيذ
يعمل كل طلب بأحد ثلاثة أوضاع (المُحدِّد بجانب عنوان URL)، لتجاوز CORS حسب الحالة:
- المتصفح (Axios) — يرسل مباشرةً من المتصفح. مثالي لواجهات API العامة التي يكون CORS مفعّلًا فيها. وهو الوضع المطلوب لـرفع الملفات (المتصفح يبني
multipart/boundary). - الخادم (Proxy) — يمرّر عبر RoqueOS Server الخاص بك (يتطلب اتصال Server Mode). يحل CORS من جهة الخادم.
- الدالة (Proxy) — يمرّر عبر Cloud Function من RoqueOS (الافتراضي). يحل CORS دون الحاجة لخادم خاص بك.
لكل طلب مهلة (30 ثانية افتراضيًا): لم يعد الـ endpoint البطيء يُجمّد التطبيق — بل تصلك رسالة انتهاء مهلة، متميّزة عن الإلغاء اليدوي.
بناء طلب
- الطريقة + العنوان: GET، POST، PUT، PATCH، DELETE، HEAD، OPTIONS.
- Params: جدول مفتاح/قيمة لسلسلة الاستعلام، مع مفتاح تفعيل لكل صف.
- Headers: جدول مفتاح/قيمة.
- Body:
- JSON / XML / Text — محرّر مع تمييز بناء الجملة.
- Form (urlencoded) — جدول مفتاح/قيمة.
- Multipart (form-data) — يتبدّل كل صف بين نص وملف (مع مُنتقي ملفات). رفع الملفات الفعلي يتطلب وضع المتصفح.
- Binary — يرسل ملفًا خامًا بنوع المحتوى الخاص به.
- Auth: لا شيء، Bearer، Basic، API Key (header/query)، OAuth 2.0 وDigest.
- السكربتات: ما قبل الطلب وما بعد الاستجابة (واجهة
pmالمتوافقة مع Postman —pm.environment.set،pm.test،pm.expect، إلخ).
OAuth 2.0 — الحصول على الرمز تلقائيًا
في Auth → OAuth 2.0 → الإعدادات المتقدمة، املأ Token URL وClient ID/Secret وScope، ثم انقر الحصول على رمز. يجلب Roqueman الرمز عبر client credentials (وفق وضع تنفيذ التبويب، فيتولى البروكسي حل CORS) ويملأ Access Token تلقائيًا.
المتغيرات والبيئات
استخدم في أي حقل (URL، headers، params، body، auth). ترتيب الحل هو: العامة ← متغيرات المجموعة ← البيئة النشطة ← وقت التشغيل (السكربتات). توجد أيضًا متغيرات ديناميكية مثل و و إلخ.
قبل الإرسال، إذا لم يُعثر على ما، فإن Roqueman ينبّهك (دون حجب) — حتى لا يُرسَل بصمت كسلسلة فارغة.
أدِر البيئات من المُحدِّد العلوي (الترس) — إنشاء وتحرير وتكرار واستيراد/تصدير وتبديل البيئة النشطة.
تسلسل الاستجابة → متغير
في تبويب استخراج، عرّف قواعد لحفظ قيم الاستجابة في متغيرات للطلب التالي — دون كتابة سكربت:
- من: Body (مسار JSON، مثل
data.token)، Header (الاسم)، أو Status. - المتغير الهدف + النطاق (Environment أو Global).
بعد كل استجابة ناجحة تُستخرج القيمة وتُحفظ (إشعار «تم حفظ المتغيرات»). هذا ما يتيح لك مثلًا تسجيل الدخول واستخدام الرمز المُعاد تلقائيًا في الطلبات اللاحقة.
المجموعات والمُشغّل
نظّم الطلبات في مجموعات مع مجلدات متداخلة. احفظ وكرّر وانقل واستورد/صدّر (صيغة Postman v2.1 وcURL وRoqueOS).
من قائمة سياق المجموعة، يفتح تشغيل المجموعة الـمُشغّل: ينفّذ جميع الطلبات بالتسلسل (الجذر والمجلدات)، ويشغّل سكربتات الاختبار، ويعرض النتيجة لكل طلب مباشرةً (الحالة، الوقت، الاختبارات ✓/✕) إضافةً إلى ملخّص نجاح/فشل. ويعمل تسلسل الاستجابة→متغير داخل المُشغّل، فتُنفَّذ التدفقات التي تعتمد فيها الطلبات على بعضها من البداية إلى النهاية.
الاستجابة
يعرض العارض الحالة والوقت والحجم، مع تبويبات Body (بتمييز ووضع خام)، وHeaders، وCookies، وTests (نتائج سكربتات ما بعد الاستجابة). يمكنك النسخ والتنزيل وتوليد كود الطلب بـ 9 لغات (cURL، Fetch، Axios، Python، PHP، Go، Java، C#، Ruby).
WebSocket وGraphQL
استخدم زر + (بجانب التبويبات) لإنشاء تبويب WebSocket أو GraphQL:
- WebSocket: اتصل، وأرسل نصًا/JSON، وراقب سجل الرسائل. مع تفعيل إعادة الاتصال التلقائي (الافتراضي)، يؤدي الانقطاع غير المتوقع إلى إعادة اتصال بتراجع أسّي — أما القطع اليدوي فلا يُعيد الاتصال.
- GraphQL: محرّر query + متغيرات + استكشاف المخطط (introspection).
التبويبات والسجل
- تبويبات متعددة الطلبات بحالة «غير محفوظ»؛ التبويبات المفتوحة والمسودة تصمد عند إعادة التحميل (لا يضيع العمل).
- سجل الطلبات المُرسَلة، مجمّع حسب التاريخ، مع بحث وإعادة تشغيل.
الأسئلة الشائعة
رفع الملفات لا يعمل. بدّل وضع التنفيذ إلى المتصفح (Axios) — فهو وحده من يبني multipart/form-data حقيقيًا. بروكسي الخادم/الدالة لا يمرّر رفع الملفات.
أين تُحفظ بياناتي؟ المجموعات والطلبات والبيئات والمتغيرات العامة والسجل تعيش في حسابك (Firebase)، متزامنة عبر الأجهزة. تبقى التبويبات المفتوحة في المتصفح المحلي.
هل متغيرات البيئة سرّية؟ تُخزَّن كنص في حسابك. لا تضع أسرار الإنتاج الحساسة في بيئات مشتركة.
ظهرت رسالة «انتهت المهلة». تجاوز الطلب 30 ثانية. تحقق من الـ endpoint أو الشبكة أو وضع التنفيذ.