डेवलपर टूल: API टोकन, REST API, CLI और «यह एरर समझाएँ»।
सही स्कोप वाले API टोकन बनाएँ, REST API के ज़रिए स्क्रिप्ट और CI से ऐप्लिकेशन पर काम करें, rivervo कमांड लाइन, और फ़ेल हुए डिप्लॉय की AI से व्याख्या।
पैनल में ऐप्लिकेशन के साथ आप जो कुछ भी करते हैं, उसे स्क्रिप्ट से भी किया जा सकता है — CI से डिप्लॉय, स्क्रिप्ट से वेरिएबल, आपके टर्मिनल में लॉग।
API टोकन
अकाउंट सेटिंग्स → API टोकन → टोकन बनाएँ। इसे एक नाम दें (जहाँ इसका इस्तेमाल होगा, जैसे «GitHub Actions») और चुनें कि यह क्या कर सकता है:
| स्कोप | क्या करने देता है |
|---|---|
| सिर्फ़ पढ़ना | ऐप्लिकेशन, डिप्लॉय और उनके लॉग, रनटाइम लॉग, डोमेन |
| पढ़ना और डिप्लॉय | पढ़ना, साथ में डिप्लॉय, रोलबैक और रीस्टार्ट |
| पूरा एक्सेस | डिप्लॉय, साथ में वेरिएबल (पढ़ना और बदलना) और डोमेन (जोड़ना, हटाना) |
| पूरा एक्सेस और टर्मिनल | पूरा एक्सेस, साथ में आपकी वेबसाइटों पर कमांड, उनकी फ़ाइलें, Cron जॉब, SSH की और Git से डिप्लॉय |
आप यह भी सेट कर सकते हैं कि यह कब एक्सपायर हो — 30, 90 या 365 दिन बाद, या कभी नहीं।
- टोकन एक बार दिखाया जाता है — इसे तुरंत कॉपी कर लें।
- टोकन आपके एक्सेस से काम करता है। किसी और के अकाउंट में यह ऐप्लिकेशन में आपके रोल से काम करता है, और उसके ऊपर टोकन का स्कोप लागू होता है। देखें ऐप्लिकेशन का एक्सेस।
- आप 20 टोकन तक रख सकते हैं। रद्द करें टोकन को तुरंत बंद कर देता है।
- अपने टोकन सिर्फ़ आप बना सकते हैं: आपकी ओर से आपके अकाउंट में लॉग इन किया हुआ कोई और व्यक्ति नहीं बना सकता।
REST API
API का दस्तावेज़ OpenAPI 3.1 में है: api.rivervo.com/api/v1/openapi.json। इसे Postman, Insomnia या किसी कोड जनरेटर में इम्पोर्ट करें।
बेस पता: https://api.rivervo.com/api/v1। टोकन को bearer टोकन के रूप में भेजें:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsआप क्या कर सकते हैं:
| मेथड और पाथ | क्या करता है | स्कोप |
|---|---|---|
GET /apps | आपके ऐप्लिकेशन और उनकी सर्विस | पढ़ना |
GET /apps/{id} | एक ऐप्लिकेशन | पढ़ना |
GET /apps/{id}/deployments | उसके डिप्लॉय | पढ़ना |
POST /apps/{id}/deployments | डिप्लॉय: सबसे नया कमिट बिल्ड करें, या {"rebuild": false} के साथ चल रहा वर्ज़न फिर से डिप्लॉय करें | डिप्लॉय |
GET /apps/{id}/deployments/{deployment} | बिल्ड लॉग के साथ एक डिप्लॉय | पढ़ना |
POST /apps/{id}/deployments/{deployment}/rollback | उस वर्ज़न पर लौटें | डिप्लॉय |
POST /apps/{id}/restart | रीस्टार्ट | डिप्लॉय |
GET /apps/{id}/logs | साइट, वर्कर या शेड्यूल के रनटाइम लॉग | पढ़ना |
GET, PUT, PATCH /apps/{id}/env | वेरिएबल पढ़ें, बदलें या अपडेट करें | पूरा |
GET /apps/{id}/domains | डोमेन | पढ़ना |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | डोमेन जोड़ें या हटाएँ | पूरा |
- किसी और का अकाउंट: जिस अकाउंट का एक्सेस आपको दिया गया है, उसके ऐप्लिकेशन पर काम करने के लिए हेडर
X-Account: <अकाउंट का कस्टमर ID>जोड़ें। - सीमाएँ: हर व्यक्ति के लिए प्रति मिनट 120 रिक्वेस्ट, जिनमें 30 बदलाव। इससे ज़्यादा होने पर API
Retry-Afterके साथ429जवाब देता है। - भाषा: संदेश डिफ़ॉल्ट रूप से अंग्रेज़ी में आते हैं; अज़रबैजानी या रूसी के लिए
Accept-Language: azयाruभेजें। - API से बदले गए वेरिएबल पैनल की तरह ही अगले डिप्लॉय के साथ ऐप्लिकेशन तक पहुँचते हैं —
{"rebuild": false}काफ़ी है।
rivervo कमांड लाइन
उन्हीं API टोकन के साथ आपके टर्मिनल से डिप्लॉय, लॉग, वेरिएबल और रोलबैक। इसके लिए Node.js 22 या नया वर्ज़न चाहिए:
npm install -g rivervo
rivervo login # टोकन पेस्ट करें
rivervo deploy shop # सबसे नया कमिट बिल्ड करें और डिप्लॉय देखें
rivervo logs shop -f # ऐप्लिकेशन का आउटपुट देखते रहें
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # पिछले वर्ज़न पर लौटेंCI में यह RIVERVO_TOKEN वेरिएबल से टोकन पढ़ता है, और नया वर्ज़न लाइव न होने पर deploy एरर के साथ बाहर निकलता है, इसलिए यह पाइपलाइन को रोक सकता है। जब तक यह पब्लिश नहीं होता, यही काम REST API से किया जा सकता है।
«यह एरर समझाएँ»
जब कोई डिप्लॉय पूरा नहीं होता, या कोई सर्विस काम करना बंद कर देती है, तो लॉग के पास यह एरर समझाएँ दिखता है। यह लॉग की आखिरी लाइनें पढ़ता है और आपकी भाषा में बताता है:
- संभावित कारण — क्या गड़बड़ हुई;
- इसे कैसे ठीक करें — आपके स्टैक के लिए ठोस कदम।
व्याख्या AI लॉग से लिखता है; कुछ भी बदलने से पहले इसे जाँच लें। कुछ भी भेजने से पहले लॉग से आपके वेरिएबल की हर वैल्यू और जो कुछ भी की, पासवर्ड या टोकन जैसा दिखता है, छिपा दिया जाता है। आपका कोड और खुद आपके वेरिएबल कभी नहीं भेजे जाते।
हर व्यक्ति दिन में 10 नई व्याख्याएँ तक माँग सकता है; उसी लॉग के लिए पहले बनी व्याख्या फिर से फ़्री में दिखाई जाती है।
Rivervo MCP
आप Rivervo MCP के ज़रिए AI असिस्टेंट से भी अपने ऐप्लिकेशन पर काम कर सकते हैं — यह Claude, ChatGPT, Cursor, VS Code और MCP सपोर्ट करने वाले दूसरे ऐप के साथ काम करता है: बातचीत में डिप्लॉय, लॉग और एरर के बारे में पूछें, और असिस्टेंट को अपनी ओर से डिप्लॉय या रोलबैक करने दें। किसी टोकन की ज़रूरत नहीं; आप अपने Rivervo अकाउंट से लॉग इन करते हैं। देखें Rivervo MCP।