使用Bitbucket API创建项目异常：POST返回GET结果问题排查

你的请求存在的问题 #

• 请求方法未正确发送：返回现有项目列表的结果，说明你的请求实际被当作GET方法发送了（比如代码/工具里的请求方法写错，或者代理/工具自动转换了请求类型）。Bitbucket API中该端点GET是查询项目，POST才是创建项目，方法错误会直接返回查询结果。
• 请求体参数错误：
  • is_private需要是布尔值true，而非字符串"true"；
  • scm参数不属于项目创建的有效字段——项目本身不绑定代码仓库类型，这个参数会被API忽略，甚至可能干扰请求解析。

正确的创建操作步骤 #

1. 确认端点与请求方法 #

使用POST方法访问正确端点：

https://api.bitbucket.org/2.0/workspaces/{你的工作区标识}/projects

注：这里的工作区标识是Bitbucket工作区的slug（即URL中的短名称，不是显示名称）

2. 正确的请求头 #

必须包含以下两个请求头：

• Authorization: Bearer {你的访问令牌}：令牌需要拥有project:write权限
• Content-Type: application/json：确保API能正确解析请求体

3. 规范的请求体 #

只保留项目创建的有效参数，示例如下：

{
  "name": "test",
  "key": "TEST",
  "is_private": true,
  "description": "测试项目" // 可选参数，可按需添加
}

说明：

• key必须在当前工作区内唯一，不能与现有项目重复
• 移除无效的scm参数

4. 验证响应结果 #

成功创建后，API会返回201 Created状态码，响应体为新创建项目的详情。如果仍返回200，必须优先检查请求方法是否确实为POST。

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