Әзірлеушілерге арналған құралдар: API токендері, REST API, CLI және «Қатені түсіндіру».
Қажетті рұқсаттары бар API токендерін жасаңыз, қолданбалармен скрипттер мен CI арқылы REST API көмегімен жұмыс істеңіз, 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 # 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-да ол токенді RIVERVO_TOKEN айнымалысынан оқиды, ал жаңа нұсқа іске қосылмаса, deploy командасы қатемен аяқталады — сондықтан оны конвейерді тоқтату шарты ретінде қолдануға болады. Ол жарияланғанға дейін дәл осыны REST API арқылы жасауға болады.
«Қатені түсіндіру»
Деплой аяқталмаса немесе сервис жұмысын тоқтатса, журналдың жанында Қатені түсіндіру батырмасы шығады. Ол журналдың соңғы жолдарын оқып, сізге өз тіліңізде айтып береді:
- Ықтимал себебі — не дұрыс болмады;
- Қалай түзетуге болады — сіздің стегіңізге арналған нақты қадамдар.
Түсіндірмені журнал бойынша AI жазады; бірдеңе өзгертпес бұрын оны тексеріп алыңыз. Ештеңе жіберілмес бұрын журналдан айнымалыларыңыздың барлық мәні және кілтке, құпиясөзге немесе токенге ұқсайтын кез келген нәрсе жасырылады. Кодыңыз бен айнымалыларыңыздың өзі ешқашан жіберілмейді.
Әр адам күніне 10 жаңа түсіндірме сұрай алады; сол журнал үшін бұрын жасалған түсіндірме қайта тегін көрсетіледі.
Rivervo MCP
Қолданбаларыңызбен AI көмекшілерінен де Rivervo MCP арқылы жұмыс істей аласыз — ол Claude, ChatGPT, Cursor, VS Code және MCP-ні қолдайтын басқа қолданбалармен жұмыс істейді: деплойлар, журналдар мен қателер туралы әңгіме барысында сұраңыз, ал көмекші сіз үшін деплой жасай алады немесе бұрынғы нұсқаға қайтара алады. Токен қажет емес; Rivervo аккаунтыңызбен кіресіз. Толығырақ: Rivervo MCP.