如何通过Vercel REST API部署指定Git分支？

前期准备 #

• 生成Vercel API令牌：登录Vercel后，进入账户设置的「Tokens」页面，创建一个拥有部署权限的令牌，务必保存好这个令牌，后续请求要用到。
• 获取项目ID：打开你的Vercel项目，进入「Settings」→「General」页面，找到「Project ID」并复制。

发起部署请求 #

用POST请求调用Vercel的部署接口，参数配置如下：

• 请求地址：https://api.vercel.com/v13/deployments
• 请求头：
  • Authorization：填 Bearer 你的API令牌（替换成实际令牌）
  • Content-Type：固定为 application/json
• 请求体（JSON格式）：

{
  "name": "你的项目名称",
  "projectId": "你的项目ID",
  "gitSource": {
    "type": "github",
    "repo": "GitHub仓库名（格式：用户名/仓库名）",
    "ref": "dev" // 替换成你要部署的目标分支名
  }
}

curl命令示例 #

直接复制下面的命令，替换占位符后就能在终端执行：

curl -X POST \
  https://api.vercel.com/v13/deployments \
  -H 'Authorization: Bearer YOUR_VERCEL_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "your-project-name",
    "projectId": "your-project-id",
    "gitSource": {
      "type": "github",
      "repo": "username/repo-name",
      "ref": "dev"
    }
  }'

注意点 #

• 确保API令牌有足够的权限操作目标项目，否则会返回权限错误。
• 请求成功后，接口会返回包含部署ID、当前状态等信息的JSON数据；如果失败，响应里会有具体错误提示，可根据提示调整配置。

内容的提问来源于stack exchange，提问作者GorvGoyl