获取当前部署
查看应用的 Git 部署配置(GET /v2/apps/:app_id/deployments/current):GitHub App 仓库、旧版 webhook,或两者兼有。
GET
获取当前部署
需要具有
apps:read 权限范围的 API 密钥。
该端点报告应用当前基于 Git 的部署配置方式:GitHub App 仓库关联、旧版 webhook URL,或两者兼有,具体取决于集成的设置方式。你可以用它在排查部署问题前检查所跟踪的仓库和分支,或确认是否仍需生成 webhook。
响应会按所有者和应用缓存 5 分钟,因此通过设置 GitHub Webhook 所做的更改可能需要几分钟才会显示在这里。在工作区共享的应用上,调用者需要具有 manager 或 admin 角色,或为所有者。若要查看部署历史而非当前配置,请使用列出部署。
webhook URL 相当于部署凭据,因此只有能够配置它的调用者才会收到完整的 URL:具有 apps:deploy 权限范围(或完全访问权限)的 API 密钥,或者在工作区共享的应用上具有 admin 角色的成员或所有者。其他调用者(例如 apps:read 密钥或 manager)会收到掩码后的 URL(https://api.squarecloud.app/v2/git/webhook/********),但仍可据此判断已配置 webhook。
参数
string
必填
应用的 ID。你可以在应用控制台的 URL 中找到它。
响应
string
指示调用是否成功。成功时为
success,否则为 error。object
响应的内容。
相关内容
- CLI:
squarecloud app deploy current - SDK:
api.apps.deploys.current()(JavaScript)、client.apps.deploys.current()(Python)、c.Apps.Deploys.Current()(Go)

