Công cụ cho nhà phát triển: API token, REST API, CLI và «Giải thích lỗi này».
Tạo API token với phạm vi quyền phù hợp, làm việc với ứng dụng từ script và CI qua REST API, dòng lệnh rivervo và phần giải thích bằng AI cho các lần deploy thất bại.
Mọi thao tác bạn làm với ứng dụng trong bảng điều khiển đều có thể tự động hóa bằng script — deploy từ CI, đặt biến từ script, xem log trong terminal.
API token
Cài đặt tài khoản → API token → Tạo token. Đặt tên (nơi sử dụng, ví dụ «GitHub Actions») và chọn quyền cho token:
| Phạm vi | Cho phép |
|---|---|
| Chỉ đọc | ứng dụng, deploy và log của chúng, log khi chạy, tên miền |
| Đọc và deploy | đọc, cùng với deploy, quay lại phiên bản cũ và khởi động lại |
| Toàn quyền | deploy, cùng với biến (đọc và thay đổi) và tên miền (thêm, gỡ) |
| Toàn quyền và terminal | toàn quyền, cùng với chạy lệnh trên website, tệp, cron job, khóa SSH và deploy từ Git |
Bạn cũng có thể đặt thời hạn — sau 30, 90 hoặc 365 ngày, hoặc không bao giờ hết hạn.
- Token chỉ hiển thị một lần — hãy sao chép ngay.
- Token hoạt động với quyền truy cập của bạn. Trong tài khoản của người khác, token hoạt động theo vai trò của bạn trong ứng dụng, và phạm vi của token được áp thêm lên đó. Xem Quyền truy cập ứng dụng.
- Bạn có thể có tối đa 20 token. Thu hồi vô hiệu hóa token ngay lập tức.
- Chỉ bạn mới tạo được token của mình: người đăng nhập vào tài khoản thay mặt bạn thì không.
REST API
API được mô tả theo chuẩn OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. Bạn có thể nhập vào Postman, Insomnia hoặc công cụ sinh mã.
Địa chỉ gốc: https://api.rivervo.com/api/v1. Gửi token dưới dạng bearer token:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsNhững gì bạn có thể làm:
| Phương thức và đường dẫn | Chức năng | Phạm vi |
|---|---|---|
GET /apps | các ứng dụng của bạn và dịch vụ của chúng | đọc |
GET /apps/{id} | một ứng dụng | đọc |
GET /apps/{id}/deployments | các lần deploy của ứng dụng | đọc |
POST /apps/{id}/deployments | deploy: build commit mới nhất, hoặc với {"rebuild": false} deploy lại phiên bản đang chạy | deploy |
GET /apps/{id}/deployments/{deployment} | một lần deploy kèm log build | đọc |
POST /apps/{id}/deployments/{deployment}/rollback | quay lại phiên bản đó | deploy |
POST /apps/{id}/restart | khởi động lại | deploy |
GET /apps/{id}/logs | log khi chạy của website, worker hoặc lịch tác vụ | đọc |
GET, PUT, PATCH /apps/{id}/env | đọc, thay thế hoặc cập nhật biến | toàn quyền |
GET /apps/{id}/domains | tên miền | đọc |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | thêm hoặc gỡ tên miền | toàn quyền |
- Tài khoản của người khác: thêm header
X-Account: <mã khách hàng của tài khoản>để làm việc với ứng dụng của tài khoản mà bạn được cấp quyền truy cập. - Giới hạn: 120 yêu cầu mỗi phút cho mỗi người, trong đó 30 yêu cầu thay đổi. Vượt quá, API trả về
429kèmRetry-After. - Ngôn ngữ: mặc định thông báo bằng tiếng Anh; gửi
Accept-Language: azhoặcruđể nhận tiếng Azerbaijan hoặc tiếng Nga. - Biến được thay đổi qua API sẽ đến ứng dụng ở lần deploy tiếp theo, giống như trong bảng điều khiển — chỉ cần
{"rebuild": false}.
Dòng lệnh rivervo
Deploy, log, biến và quay lại phiên bản cũ ngay từ terminal, với cùng các API token. Cần Node.js 22 trở lên:
npm install -g rivervo
rivervo login # dán token
rivervo deploy shop # build commit mới nhất và theo dõi deploy
rivervo logs shop -f # theo dõi output của ứng dụng
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # quay lại phiên bản trướcTrong CI, công cụ đọc token từ biến RIVERVO_TOKEN, và deploy kết thúc với mã lỗi khi phiên bản mới không chạy được, nên có thể dùng để chặn pipeline. Cho đến khi công cụ được phát hành, bạn có thể làm điều tương tự bằng REST API.
«Giải thích lỗi này»
Khi một lần deploy không hoàn tất, hoặc một dịch vụ ngừng hoạt động, nút Giải thích lỗi này xuất hiện bên cạnh log. Nó đọc các dòng cuối của log và cho bạn biết, bằng ngôn ngữ của bạn:
- Nguyên nhân có thể — điều gì đã xảy ra;
- Cách khắc phục — các bước cụ thể cho stack của bạn.
Phần giải thích do AI viết dựa trên log; hãy kiểm tra trước khi thay đổi bất cứ điều gì. Trước khi gửi, mọi giá trị biến của bạn và bất cứ thứ gì trông giống khóa, mật khẩu hoặc token đều được ẩn khỏi log. Mã nguồn và bản thân các biến của bạn không bao giờ được gửi đi.
Mỗi người có thể yêu cầu tối đa 10 giải thích mới mỗi ngày; giải thích đã tạo cho cùng một log sẽ được hiển thị lại miễn phí.
Rivervo MCP
Bạn cũng có thể làm việc với ứng dụng từ các trợ lý AI qua Rivervo MCP — hoạt động với Claude, ChatGPT, Cursor, VS Code và các ứng dụng khác hỗ trợ MCP: hỏi về deploy, log và lỗi ngay trong cuộc trò chuyện, và để trợ lý deploy hoặc quay lại phiên bản cũ giúp bạn. Không cần token; bạn đăng nhập bằng tài khoản Rivervo. Xem Rivervo MCP.