Tool developer: token API, REST API, CLI, dan «Jelaskan error ini».
Buat token API dengan cakupan yang tepat, kelola aplikasi dari script dan CI melalui REST API, command line rivervo, serta penjelasan dari AI untuk deploy yang gagal.
Semua yang Anda lakukan dengan aplikasi di panel juga bisa dijalankan lewat script — deploy dari CI, variabel dari script, log di terminal Anda.
Token API
Pengaturan akun → Token API → Buat token. Beri nama (tempat token dipakai, misalnya «GitHub Actions») dan pilih apa yang boleh dilakukannya:
| Cakupan | Mengizinkan |
|---|---|
| Hanya baca | aplikasi, deploy beserta log-nya, log runtime, domain |
| Baca dan deploy | baca, ditambah deploy, rollback, dan restart |
| Akses penuh | deploy, ditambah variabel (baca dan ubah) dan domain (tambah, hapus) |
| Akses penuh dan terminal | akses penuh, ditambah perintah di website Anda, file-nya, cron job, SSH key, dan deploy dari Git |
Anda juga bisa mengatur masa berlakunya — 30, 90, atau 365 hari, atau tanpa batas.
- Token hanya ditampilkan sekali — segera salin.
- Token bertindak dengan akses Anda. Di akun orang lain, token bertindak dengan peran Anda di aplikasi, dan cakupan token berlaku di atasnya. Lihat Akses ke aplikasi.
- Anda bisa memiliki hingga 20 token. Cabut langsung menonaktifkan token.
- Hanya Anda yang bisa membuat token Anda: orang yang masuk ke akun Anda atas nama Anda tidak bisa.
REST API
API didokumentasikan dalam OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Impor ke Postman, Insomnia, atau generator kode.
Alamat dasar: https://api.rivervo.com/api/v1. Kirim token sebagai bearer token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsYang bisa Anda lakukan:
| Metode dan path | Fungsinya | Cakupan |
|---|---|---|
GET /apps | aplikasi Anda beserta layanannya | baca |
GET /apps/{id} | satu aplikasi | baca |
GET /apps/{id}/deployments | deploy-nya | baca |
POST /apps/{id}/deployments | deploy: build commit terbaru, atau dengan {"rebuild": false} deploy ulang versi yang berjalan | deploy |
GET /apps/{id}/deployments/{deployment} | satu deploy beserta log build-nya | baca |
POST /apps/{id}/deployments/{deployment}/rollback | kembali ke versi tersebut | deploy |
POST /apps/{id}/restart | restart | deploy |
GET /apps/{id}/logs | log runtime website, worker, atau jadwal | baca |
GET, PUT, PATCH /apps/{id}/env | baca, ganti, atau perbarui variabel | penuh |
GET /apps/{id}/domains | domain | baca |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | tambah atau hapus domain | penuh |
- Akun orang lain: tambahkan header
X-Account: <the account's customer ID>untuk bekerja dengan aplikasi di akun yang aksesnya diberikan kepada Anda. - Batas: 120 request per menit per orang, 30 di antaranya perubahan. Jika terlampaui, API membalas
429denganRetry-After. - Bahasa: pesan dikirim dalam bahasa Inggris secara default; kirim
Accept-Language: azatauruuntuk bahasa Azerbaijan atau Rusia. - Variabel yang diubah melalui API sampai ke aplikasi pada deploy berikutnya, sama seperti di panel —
{"rebuild": false}sudah cukup.
Command line rivervo
Deploy, log, variabel, dan rollback dari terminal Anda, dengan token API yang sama. Memerlukan Node.js 22 atau yang lebih baru:
npm install -g rivervo
rivervo login # tempel token
rivervo deploy shop # build commit terbaru dan pantau deploy
rivervo logs shop -f # pantau output aplikasi
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # kembali ke versi sebelumnyaDi CI, CLI membaca token dari variabel RIVERVO_TOKEN, dan deploy keluar dengan error jika versi baru tidak tayang, sehingga bisa dipakai sebagai gerbang pipeline. Sampai CLI ini dipublikasikan, hal yang sama bisa dilakukan dengan REST API.
«Jelaskan error ini»
Saat deploy tidak selesai, atau sebuah layanan berhenti bekerja, Jelaskan error ini muncul di samping log. Fitur ini membaca baris terakhir log dan menjelaskan dalam bahasa Anda:
- Kemungkinan penyebab — apa yang salah;
- Cara memperbaikinya — langkah konkret untuk stack Anda.
Penjelasan ditulis oleh AI berdasarkan log; periksa dulu sebelum Anda mengubah apa pun. Sebelum apa pun dikirim, setiap nilai variabel Anda dan apa pun yang terlihat seperti key, password, atau token disembunyikan dari log. Kode dan variabel Anda sendiri tidak pernah dikirim.
Setiap orang bisa meminta hingga 10 penjelasan baru per hari; penjelasan yang sudah dibuat untuk log yang sama ditampilkan lagi secara gratis.
Rivervo MCP
Anda juga bisa mengelola aplikasi dari asisten AI melalui Rivervo MCP — berfungsi dengan Claude, ChatGPT, Cursor, VS Code, dan aplikasi lain yang mendukung MCP: tanyakan tentang deploy, log, dan error dalam percakapan, dan biarkan asisten melakukan deploy atau rollback untuk Anda. Tidak perlu token; Anda masuk dengan akun Rivervo. Lihat Rivervo MCP.