Roqueman API Client
Roqueman RoqueOS का API क्लाइंट है — आपके वेब डेस्कटॉप के भीतर चलने वाला एक Postman/Insomnia। HTTP, WebSocket और GraphQL रिक्वेस्ट बनाएँ और भेजें, सब कुछ कलेक्शन में व्यवस्थित करें, वेरिएबल और एनवायरनमेंट का उपयोग करें, टेस्ट स्क्रिप्ट लिखें, और रिस्पॉन्स चेनिंग तथा कलेक्शन रनर से फ़्लो को स्वचालित करें — कुछ भी इंस्टॉल किए बिना।
यह क्यों उपयोगी है
आप अपने API वहीं टेस्ट करते हैं जहाँ पहले से काम करते हैं, और डेटा आपके अकाउंट से सिंक रहता है। कोई अलग ऐप नहीं, कोई अतिरिक्त लॉगिन नहीं — Launchpad से Roqueman खोलें और शुरू करें।
एडमिन: स्वचालित सर्वर संग्रह
किसी सर्वर से जुड़े एडमिन को RoqueOS Server संग्रह (सर्वर API के सभी एंडपॉइंट) स्वतः लोड मिलता है, साथ ही सक्रिय सर्वर की ओर इंगित करने वाला एनवायरनमेंट — चलाने के लिए तैयार।
एक्ज़ीक्यूशन मोड
हर रिक्वेस्ट तीन मोड में से एक में चलती है (URL के बगल वाला सेलेक्टर), ताकि स्थिति के अनुसार CORS को संभाला जा सके:
- ब्राउज़र (Axios) — सीधे ब्राउज़र से भेजता है। CORS-सक्षम सार्वजनिक API के लिए आदर्श। फ़ाइल अपलोड के लिए यही मोड ज़रूरी है (ब्राउज़र
multipart/boundaryबनाता है)। - सर्वर (Proxy) — आपके RoqueOS Server के ज़रिए फ़ॉरवर्ड करता है (Server Mode कनेक्टेड होना चाहिए)। CORS सर्वर-साइड हल करता है।
- फ़ंक्शन (Proxy) — RoqueOS Cloud Function के ज़रिए फ़ॉरवर्ड करता है (डिफ़ॉल्ट)। अपने सर्वर के बिना CORS हल करता है।
हर रिक्वेस्ट में टाइमआउट होता है (डिफ़ॉल्ट 30 सेकंड): धीमा एंडपॉइंट अब ऐप को फ़्रीज़ नहीं करता — आपको टाइमआउट सूचना मिलती है, जो मैन्युअल कैंसिल से अलग होती है।
रिक्वेस्ट बनाना
- मेथड + URL: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS।
- Params: क्वेरी स्ट्रिंग की की/वैल्यू टेबल, प्रति-पंक्ति टॉगल के साथ।
- Headers: की/वैल्यू टेबल।
- Body:
- JSON / XML / Text — सिंटैक्स हाइलाइटिंग वाला एडिटर।
- Form (urlencoded) — की/वैल्यू टेबल।
- Multipart (form-data) — हर पंक्ति टेक्स्ट और फ़ाइल के बीच टॉगल होती है (फ़ाइल पिकर के साथ)। असली फ़ाइल अपलोड के लिए ब्राउज़र मोड ज़रूरी है।
- Binary — फ़ाइल को उसके अपने content-type के साथ कच्चा भेजता है।
- Auth: कोई नहीं, Bearer, Basic, API Key (header/query), OAuth 2.0 और Digest।
- स्क्रिप्ट: प्री-रिक्वेस्ट और पोस्ट-रिस्पॉन्स (Postman-संगत
pmAPI —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 एडिटर + वेरिएबल + schema इंट्रोस्पेक्शन।
टैब और इतिहास
- मल्टी-रिक्वेस्ट टैब "असहेजा" स्थिति के साथ; खुले टैब और ड्राफ़्ट रीलोड के बाद भी बने रहते हैं (काम नहीं खोता)।
- भेजी गई रिक्वेस्ट का इतिहास, तिथि के अनुसार समूहित, खोज और रीप्ले के साथ।
सामान्य प्रश्न
फ़ाइल अपलोड काम नहीं कर रहा। एक्ज़ीक्यूशन मोड को ब्राउज़र (Axios) पर बदलें — असली multipart/form-data केवल यही बनाता है। सर्वर/फ़ंक्शन प्रॉक्सी फ़ाइल अपलोड फ़ॉरवर्ड नहीं करता।
मेरा डेटा कहाँ सहेजा जाता है? कलेक्शन, रिक्वेस्ट, एनवायरनमेंट, ग्लोबल और इतिहास आपके अकाउंट (Firebase) में रहते हैं, डिवाइसों के बीच सिंक। खुले टैब लोकल ब्राउज़र में रहते हैं।
क्या एनवायरनमेंट वेरिएबल गुप्त हैं? वे आपके अकाउंट में टेक्स्ट के रूप में संग्रहीत होते हैं। संवेदनशील प्रोडक्शन सीक्रेट साझा एनवायरनमेंट में न रखें।
इसने "टाइमआउट" कहा। रिक्वेस्ट 30 सेकंड से अधिक हो गई। एंडपॉइंट, नेटवर्क या एक्ज़ीक्यूशन मोड जाँचें।