用你的程式碼、編輯器或 AI 來操作 Bot-Hosting。

REST API、MCP 伺服器、OAuth 登入與 CLI,操作、權限和速率限制都與儀表板相同。

公開測試版。 盡情動手打造與實驗,但請小心使用:端點可能仍會變動,而且每次呼叫都會作用在你真實的部署上。
REST API 71 個端點,操控你的帳號:部署、檔案、環境變數、備份、套件與網域。 Bearer bhk_ 金鑰,每分鐘 120 次請求 MCP 伺服器 相同的 71 項操作化為工具,讓 ChatGPT、Claude Desktop 或 Cursor 管理你的部署。 ChatGPT 使用 OAuth,其他使用 API 金鑰 OAuth 2.1 讓你的使用者以 Bot-Hosting 帳號登入,並在他們核准的權限範圍內操作。 PKCE,存取 Token 7 天,更新 Token 30 天 CLI 將資料夾連結到部署,並從你自己的編輯器推送每次儲存。 npm i -g bot-hosting

一把金鑰,一次請求

在開發者設定中建立金鑰,只授予所需的權限範圍,再以 Bearer Token 傳送。

基礎 URL:https://bot-hosting.net/api/v1
curl -H "Authorization: Bearer bhk_your_key" \
  https://bot-hosting.net/api/v1/deployments
回應 200
{
  "deployments": [ … ]
}

權限範圍

API 金鑰、MCP 與 OAuth 共用同一份清單。只有在金鑰具備該權限範圍,且你對該資源有權限時,請求才會執行。

部署

  • deployments:read 列出並檢視部署
  • deployments:power 啟動、停止、重新啟動、主控台
  • deployments:write 建立、編輯、刪除、調整規格、搬移
  • deployments:shell 在容器中執行 Shell 命令
  • projects:read 列出你的專案
  • projects:write 建立與刪除專案
  • files:read 瀏覽與下載檔案
  • files:write 上傳、編輯、重新命名、刪除檔案
  • env:read 讀取環境變數(機密會遮蔽)
  • env:write 設定環境變數
  • backups:read 列出還原點
  • backups:write 建立、還原、刪除還原點
  • packages:read 檢視已安裝的套件
  • packages:write 新增與移除套件

帳號

  • account:read 讀取個人資料與配額
  • billing:read 讀取發票與方案
  • credits:spend 花費點數以建立資源

範本與文件

  • templates:read 瀏覽公開範本
  • docs:read 搜尋並閱讀文件