Mulakan

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.

4 MIN BACAAN

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:

SkopMembenarkan
Baca sahajaaplikasi, deploy dan lognya, log masa jalan, domain
Baca dan deploybaca, serta deploy, rollback dan mula semula
Akses penuhdeploy, serta pemboleh ubah (baca dan ubah) dan domain (tambah, alih keluar)
Akses penuh dan terminalakses 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/apps

Apa yang boleh anda lakukan:

Kaedah dan laluanFungsinyaSkop
GET /appsaplikasi anda dan perkhidmatannyabaca
GET /apps/{id}satu aplikasibaca
GET /apps/{id}/deploymentsdeploynyabaca
POST /apps/{id}/deploymentsdeploy: bina commit terkini, atau dengan {"rebuild": false} deploy semula versi yang sedang berjalandeploy
GET /apps/{id}/deployments/{deployment}deploy dengan log binaannyabaca
POST /apps/{id}/deployments/{deployment}/rollbackkembali ke versi tersebutdeploy
POST /apps/{id}/restartmula semuladeploy
GET /apps/{id}/logslog masa jalan laman web, worker atau jadualbaca
GET, PUT, PATCH /apps/{id}/envbaca, ganti atau kemas kini pemboleh ubahpenuh
GET /apps/{id}/domainsdomainbaca
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}tambah atau alih keluar domainpenuh
  • 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 429 dengan Retry-After.
  • Bahasa: mesej dalam bahasa Inggeris secara lalai; hantar Accept-Language: az atau ru untuk 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 sebelumnya

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

Masih perlukan bantuan?

Bersembang dengan kami — AI menjawab serta-merta dan jurutera menyertai apabila perlu, pada bila-bila masa.

Hubungi sokongan