Dasturchi vositalari: API tokenlari, REST API, CLI va «Bu xatoni tushuntiring».
Kerakli huquqlarga ega API tokenlarini yarating, skriptlar va CI dan REST API orqali ilovalar bilan ishlang, rivervo buyruq qatoridan foydalaning va muvaffaqiyatsiz deploylar uchun AI tushuntirishlarini oling.
Paneldagi ilovalar bilan qiladigan har bir ishingizni skript orqali ham bajarish mumkin — CI dan deploy, skriptdan oʻzgaruvchilar, terminalda loglar.
API tokenlari
Akkaunt sozlamalari → API tokenlari → Token yaratish. Unga nom bering (qayerda ishlatilishi, masalan, «GitHub Actions») va nimalarga ruxsat berilishini tanlang:
| Huquqlar | Nimaga ruxsat beradi |
|---|---|
| Faqat oʻqish | ilovalar, deploylar va ularning loglari, ishlash loglari, domenlar |
| Oʻqish va deploy | oʻqish, shuningdek deploy, orqaga qaytish va qayta ishga tushirish |
| Toʻliq kirish | deploy, shuningdek oʻzgaruvchilar (oʻqish va oʻzgartirish) va domenlar (qoʻshish, olib tashlash) |
| Toʻliq kirish va terminal | toʻliq kirish, shuningdek saytlaringizda buyruqlar, ularning fayllari, cron vazifalari, SSH kalitlari va Gitdan deploy |
Amal qilish muddatini ham belgilashingiz mumkin — 30, 90 yoki 365 kundan keyin yoki muddatsiz.
- Token bir marta koʻrsatiladi — uni darhol nusxalab oling.
- Token sizning huquqlaringiz bilan ishlaydi. Boshqa birovning akkauntida u ilovadagi rolingiz bilan ishlaydi, token huquqlari esa bunga qoʻshimcha cheklov sifatida amal qiladi. Batafsil: Ilovaga kirish huquqlari.
- 20 tagacha token saqlashingiz mumkin. Bekor qilish tokenni darhol oʻchiradi.
- Tokenlaringizni faqat oʻzingiz yarata olasiz: akkauntingizga siz nomingizdan kirgan boshqa odam buni qila olmaydi.
REST API
API OpenAPI 3.1 formatida tavsiflangan: api.rivervo.com/api/v1/openapi.json. Uni Postman, Insomnia yoki kod generatoriga import qiling.
Asosiy manzil: https://api.rivervo.com/api/v1. Tokenni bearer token sifatida yuboring:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsNimalar qilish mumkin:
| Metod va yoʻl | Nima qiladi | Huquqlar |
|---|---|---|
GET /apps | ilovalaringiz va ularning xizmatlari | oʻqish |
GET /apps/{id} | bitta ilova | oʻqish |
GET /apps/{id}/deployments | uning deploylari | oʻqish |
POST /apps/{id}/deployments | deploy: oxirgi commitni yigʻish yoki {"rebuild": false} bilan ishlab turgan versiyani qayta deploy qilish | deploy |
GET /apps/{id}/deployments/{deployment} | yigʻish logi bilan deploy | oʻqish |
POST /apps/{id}/deployments/{deployment}/rollback | oʻsha versiyaga qaytish | deploy |
POST /apps/{id}/restart | qayta ishga tushirish | deploy |
GET /apps/{id}/logs | sayt, worker yoki jadval boʻyicha vazifalarning ishlash loglari | oʻqish |
GET, PUT, PATCH /apps/{id}/env | oʻzgaruvchilarni oʻqish, almashtirish yoki yangilash | toʻliq |
GET /apps/{id}/domains | domenlar | oʻqish |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | domen qoʻshish yoki olib tashlash | toʻliq |
- Boshqa birovning akkaunti: sizga kirish huquqi berilgan akkaunt ilovalari bilan ishlash uchun
X-Account: <the account's customer ID>sarlavhasini qoʻshing. - Cheklovlar: har bir foydalanuvchiga daqiqasiga 120 ta soʻrov, shundan 30 tasi oʻzgartirish. Undan oshsa, API
Retry-Afterbilan429javobini qaytaradi. - Til: xabarlar odatda ingliz tilida keladi; ozarbayjon yoki rus tili uchun
Accept-Language: azyokiruyuboring. - API orqali oʻzgartirilgan oʻzgaruvchilar, paneldagi kabi, ilovaga keyingi deploy bilan yetib boradi —
{"rebuild": false}yetarli.
rivervo buyruq qatori
Terminalingizdan oʻsha API tokenlari bilan deploylar, loglar, oʻzgaruvchilar va orqaga qaytish. Node.js 22 yoki undan yangi versiyasi kerak:
npm install -g rivervo
rivervo login # paste the token
rivervo deploy shop # build the latest commit and follow the deploy
rivervo logs shop -f # follow the application's output
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # back to the previous versionCI da u tokenni RIVERVO_TOKEN oʻzgaruvchisidan oʻqiydi, yangi versiya ishga tushmasa esa deploy xato bilan yakunlanadi — shuning uchun undan pipelineʼni toʻxtatish uchun foydalanish mumkin. U eʼlon qilinguncha xuddi shu ishni REST API orqali bajarish mumkin.
«Bu xatoni tushuntiring»
Deploy yakunlanmasa yoki xizmat ishlamay qolsa, log yonida Bu xatoni tushuntiring tugmasi paydo boʻladi. U logning oxirgi qatorlarini oʻqiydi va sizga oʻz tilingizda aytib beradi:
- Ehtimoliy sabab — nima notoʻgʻri ketgani;
- Qanday tuzatish mumkin — stekingiz uchun aniq qadamlar.
Tushuntirishni AI log asosida yozadi; biror narsani oʻzgartirishdan oldin uni tekshirib chiqing. Hech narsa yuborilishidan oldin logdan oʻzgaruvchilaringizning barcha qiymatlari hamda kalit, parol yoki tokenga oʻxshagan hamma narsa yashiriladi. Kodingiz va oʻzgaruvchilaringizning oʻzi hech qachon yuborilmaydi.
Har bir foydalanuvchi kuniga 10 tagacha yangi tushuntirish soʻrashi mumkin; xuddi shu log uchun avval tayyorlangan tushuntirish bepul qayta koʻrsatiladi.
Rivervo MCP
Ilovalaringiz bilan AI yordamchilardan Rivervo MCP orqali ham ishlashingiz mumkin — u Claude, ChatGPT, Cursor, VS Code va MCP ni qoʻllab-quvvatlaydigan boshqa ilovalar bilan ishlaydi: suhbat davomida deploylar, loglar va xatolar haqida soʻrang, yordamchiga esa siz uchun deploy qilish yoki orqaga qaytishni topshiring. Token kerak emas; Rivervo akkauntingiz bilan kirasiz. Batafsil: Rivervo MCP.