立即開始

開發人員工具:API 權杖、REST API、CLI 與「解釋此錯誤」。

建立權限範圍合適的 API 權杖,透過 REST API 從指令碼與 CI 操作應用程式,使用 rivervo 命令列,並取得 AI 對部署失敗的解釋。

1 分鐘閱讀

您在控制台中對應用程式所做的一切,也都可以用指令碼完成——從 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。

還有問題嗎?

和我們對談——AI 會立即回覆,需要時由工程師加入,全天候服務。

聯絡客服