分支：创建分支

路由 URL

POST https://playcanvas.com/api/branches

说明

从已有分支创建新分支，也可指定源检查点。

示例

curl -H "Authorization: Bearer {accessToken}" -H "Content-Type: application/json" -X POST -d '{"projectId": {projectId}, "name": "My New Branch", "sourceBranchId": "{sourceBranchId}"}' "https://playcanvas.com/api/branches"

HTTP 请求

POST https://playcanvas.com/api/branches
Authorization: Bearer {accessToken}
Content-Type: application/json

{
    "projectId": {projectId},
    "name": "My New Branch",
    "sourceBranchId": "{sourceBranchId}"
}

参数

名称	类型	必需	说明
name	string	✔️	新分支名称，不能为空，且不得超过 1000 个字符。
projectId	number	✔️	项目 ID。
sourceBranchId	string	✔️	创建新分支所依据的源分支 ID。
sourceCheckpointId	string		创建新分支所依据的检查点 ID，必须属于源分支。未指定时使用源分支的最新检查点。

响应结构

Status: 201 Created

{
    "id": string,
    "projectId": int,
    "name": string,
    "createdAt": date,
    "closed": bool,
    "permanent": bool,
    "latestCheckpointId": string,
    "user": {
        "id": int,
        "fullName": string,
        "username": string
    }
}

错误

状态码	说明
400	请求无效／分支名称已存在
401	未通过身份验证
403	禁止访问
404	未找到项目／分支
429	请求过多

请求限流

此路由采用普通限流。