Alat pembangun: token API, REST API, CLI dan «Terangkan ralat ini».
Cipta token API dengan skop yang betul, urus aplikasi daripada skrip dan CI melalui REST API, baris arahan rivervo, dan penjelasan oleh AI bagi deploy yang gagal.
Semua yang anda lakukan dengan aplikasi dalam panel juga boleh dijalankan melalui skrip — deploy daripada CI, pemboleh ubah daripada skrip, log dalam terminal anda.
Token API
Tetapan akaun → Token API → Cipta token. Berikan nama (tempat ia digunakan, cth. «GitHub Actions») dan pilih apa yang dibenarkan:
| Skop | Membenarkan |
|---|---|
| Baca sahaja | aplikasi, deploy dan lognya, log masa jalan, domain |
| Baca dan deploy | baca, serta deploy, rollback dan mula semula |
| Akses penuh | deploy, serta pemboleh ubah (baca dan ubah) dan domain (tambah, alih keluar) |
| Akses penuh dan terminal | akses penuh, serta arahan pada laman web anda, failnya, tugas cron, kunci SSH dan deploy daripada Git |
Anda juga boleh menetapkan bila ia tamat tempoh — selepas 30, 90 atau 365 hari, atau tidak pernah.
- Token dipaparkan sekali sahaja — salin dengan segera.
- Token bertindak dengan akses anda. Dalam akaun orang lain, ia bertindak dengan peranan anda dalam aplikasi, dan skop token terpakai di atasnya. Lihat Akses kepada aplikasi.
- Anda boleh memegang sehingga 20 token. Batalkan menghentikan token serta-merta.
- Hanya anda boleh mencipta token anda: seseorang yang log masuk ke akaun anda bagi pihak anda tidak boleh.
REST API
API didokumenkan dalam OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Import ke Postman, Insomnia atau penjana kod.
Alamat asas: https://api.rivervo.com/api/v1. Hantar token sebagai token bearer:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsApa yang boleh anda lakukan:
| Kaedah dan laluan | Fungsinya | Skop |
|---|---|---|
GET /apps | aplikasi anda dan perkhidmatannya | baca |
GET /apps/{id} | satu aplikasi | baca |
GET /apps/{id}/deployments | deploynya | baca |
POST /apps/{id}/deployments | deploy: bina commit terkini, atau dengan {"rebuild": false} deploy semula versi yang sedang berjalan | deploy |
GET /apps/{id}/deployments/{deployment} | deploy dengan log binaannya | baca |
POST /apps/{id}/deployments/{deployment}/rollback | kembali ke versi tersebut | deploy |
POST /apps/{id}/restart | mula semula | deploy |
GET /apps/{id}/logs | log masa jalan laman web, worker atau jadual | baca |
GET, PUT, PATCH /apps/{id}/env | baca, ganti atau kemas kini pemboleh ubah | penuh |
GET /apps/{id}/domains | domain | baca |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | tambah atau alih keluar domain | penuh |
- Akaun orang lain: tambah pengepala
X-Account: <ID pelanggan akaun tersebut>untuk mengurus aplikasi akaun yang anda diberi akses. - Had: 120 permintaan seminit bagi setiap orang, termasuk 30 perubahan. Melebihi had, API menjawab
429denganRetry-After. - Bahasa: mesej dalam bahasa Inggeris secara lalai; hantar
Accept-Language: azatauruuntuk bahasa Azerbaijan atau Rusia. - Pemboleh ubah yang diubah melalui API sampai ke aplikasi pada deploy seterusnya, sama seperti dalam panel —
{"rebuild": false}sudah memadai.
Baris arahan rivervo
Deploy, log, pemboleh ubah dan rollback daripada terminal anda, dengan token API yang sama. Ia memerlukan Node.js 22 atau lebih baharu:
npm install -g rivervo
rivervo login # tampal token
rivervo deploy shop # bina commit terkini dan ikuti deploy
rivervo logs shop -f # ikuti output aplikasi
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # kembali ke versi sebelumnyaDalam CI, ia membaca token daripada pemboleh ubah RIVERVO_TOKEN, dan deploy keluar dengan ralat apabila versi baharu tidak disiarkan, jadi ia boleh mengawal pipeline. Sehingga ia diterbitkan, perkara yang sama boleh dilakukan dengan REST API.
«Terangkan ralat ini»
Apabila deploy tidak selesai, atau perkhidmatan berhenti berfungsi, Terangkan ralat ini muncul di sebelah log. Ia membaca baris terakhir log dan memberitahu anda, dalam bahasa anda:
- Punca yang mungkin — apa yang tidak kena;
- Cara membaikinya — langkah konkrit untuk stack anda.
Penjelasan ditulis oleh AI berdasarkan log; semak dahulu sebelum anda mengubah apa-apa. Sebelum apa-apa dihantar, setiap nilai pemboleh ubah anda dan apa sahaja yang kelihatan seperti kunci, kata laluan atau token disembunyikan daripada log. Kod dan pemboleh ubah anda sendiri tidak pernah dihantar.
Setiap orang boleh meminta sehingga 10 penjelasan baharu sehari; penjelasan yang sudah dibuat untuk log yang sama dipaparkan semula secara percuma.
Rivervo MCP
Anda juga boleh mengurus aplikasi anda daripada pembantu AI melalui Rivervo MCP — ia berfungsi dengan Claude, ChatGPT, Cursor, VS Code dan aplikasi lain yang menyokong MCP: tanya tentang deploy, log dan ralat dalam perbualan, dan biarkan pembantu melakukan deploy atau rollback untuk anda. Tiada token diperlukan; anda log masuk dengan akaun Rivervo anda. Lihat Rivervo MCP.