शुरू करें

डेवलपर टूल: API टोकन, REST API, CLI और «यह एरर समझाएँ»।

सही स्कोप वाले API टोकन बनाएँ, REST API के ज़रिए स्क्रिप्ट और CI से ऐप्लिकेशन पर काम करें, rivervo कमांड लाइन, और फ़ेल हुए डिप्लॉय की AI से व्याख्या।

4 मिनट में पढ़ें

पैनल में ऐप्लिकेशन के साथ आप जो कुछ भी करते हैं, उसे स्क्रिप्ट से भी किया जा सकता है — 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।

अब भी कोई सवाल है?

हमसे चैट करें — AI तुरंत जवाब देता है और ज़रूरत पड़ने पर इंजीनियर जुड़ जाता है, दिन के किसी भी समय।

सपोर्ट से संपर्क करें