開發人員工具:API 權杖、REST API、CLI 與「解釋此錯誤」。
建立權限範圍合適的 API 權杖,透過 REST API 從指令碼與 CI 操作應用程式,使用 rivervo 命令列,並取得 AI 對部署失敗的解釋。
您在控制台中對應用程式所做的一切,也都可以用指令碼完成——從 CI 部署、用指令碼設定變數、在終端機查看記錄。
API 權杖
帳戶設定 → API 權杖 → 建立權杖。為它命名(使用的地方,例如「GitHub Actions」),並選擇它能做的事:
| 權限範圍 | 允許 |
|---|---|
| 唯讀 | 應用程式、部署及其記錄、執行記錄、網域 |
| 讀取與部署 | 讀取,加上部署、回復與重新啟動 |
| 完整存取 | 部署,加上變數(讀取與變更)及網域(新增、移除) |
| 完整存取與終端機 | 完整存取,加上在您網站上執行指令、其檔案、排程工作、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: <the account's customer ID>,即可操作您獲授存取權的帳戶中的應用程式。 - **限制:**每人每分鐘 120 個請求,其中變更操作 30 個。超過時 API 會回應
429並附上Retry-After。 - **語言:**訊息預設為英文;傳送
Accept-Language: az或ru可取得亞塞拜然文或俄文。 - 透過 API 變更的變數,與控制台相同,會在下次部署時套用到應用程式——使用
{"rebuild": false}即可。
rivervo 命令列
使用相同的 API 權杖,在終端機進行部署、查看記錄、設定變數與回復。需要 Node.js 22 或更新版本:
npm install -g rivervo
rivervo login # 貼上權杖
rivervo deploy shop # 建置最新的提交並追蹤部署
rivervo logs shop -f # 追蹤應用程式的輸出
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # 回到上一個版本在 CI 中,它會從 RIVERVO_TOKEN 變數讀取權杖;新版本未能上線時,deploy 會以錯誤結束,因此可用來把關流程。在它正式發布前,也可以透過 REST API 完成相同操作。
「解釋此錯誤」
部署未完成或服務停止運作時,記錄旁會出現解釋此錯誤。它會讀取記錄的最後幾行,並以您的語言說明:
- 可能原因——哪裡出了問題;
- 修正方式——針對您技術堆疊的具體步驟。
解釋是由 AI 根據記錄撰寫;變更任何設定前請先確認。傳送前,記錄中您所有變數的值,以及任何看似金鑰、密碼或權杖的內容都會被隱藏。您的程式碼和變數本身絕不會被傳送。
每人每天最多可要求 10 次新的解釋;同一份記錄已產生過的解釋會免費再次顯示。
Rivervo MCP
您也可以透過 Rivervo MCP 從 AI 助理操作您的應用程式——支援 Claude、ChatGPT、Cursor、VS Code 及其他支援 MCP 的應用程式:在對話中詢問部署、記錄與錯誤,並讓助理為您部署或回復。不需要權杖,只要以您的 Rivervo 帳戶登入即可。請參閱 Rivervo MCP。