Boshlash

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.

4 DAQIQA OʻQISH

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:

HuquqlarNimaga ruxsat beradi
Faqat oʻqishilovalar, deploylar va ularning loglari, ishlash loglari, domenlar
Oʻqish va deployoʻqish, shuningdek deploy, orqaga qaytish va qayta ishga tushirish
Toʻliq kirishdeploy, shuningdek oʻzgaruvchilar (oʻqish va oʻzgartirish) va domenlar (qoʻshish, olib tashlash)
Toʻliq kirish va terminaltoʻ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/apps

Nimalar qilish mumkin:

Metod va yoʻlNima qiladiHuquqlar
GET /appsilovalaringiz va ularning xizmatlarioʻqish
GET /apps/{id}bitta ilovaoʻqish
GET /apps/{id}/deploymentsuning deploylarioʻqish
POST /apps/{id}/deploymentsdeploy: oxirgi commitni yigʻish yoki {"rebuild": false} bilan ishlab turgan versiyani qayta deploy qilishdeploy
GET /apps/{id}/deployments/{deployment}yigʻish logi bilan deployoʻqish
POST /apps/{id}/deployments/{deployment}/rollbackoʻsha versiyaga qaytishdeploy
POST /apps/{id}/restartqayta ishga tushirishdeploy
GET /apps/{id}/logssayt, worker yoki jadval boʻyicha vazifalarning ishlash loglarioʻqish
GET, PUT, PATCH /apps/{id}/envoʻzgaruvchilarni oʻqish, almashtirish yoki yangilashtoʻliq
GET /apps/{id}/domainsdomenlaroʻqish
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}domen qoʻshish yoki olib tashlashtoʻ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-After bilan 429 javobini qaytaradi.
  • Til: xabarlar odatda ingliz tilida keladi; ozarbayjon yoki rus tili uchun Accept-Language: az yoki ru yuboring.
  • 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 version

CI 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.

Hali ham savollar bormi?

Bizga chatda yozing — AI darhol javob beradi, kerak boʻlsa muhandis qoʻshiladi, kunning istalgan vaqtida.

Yordamga yozish