如何通过projects.repos.create API创建Git仓库？报错求示例代码

我之前折腾这个API的时候也踩过不少坑，结合你的情况，大概率是下面几个细节没做好，你可以逐个排查：

• 确认项目标识的完整性
  你提到example是已存在的项目，要注意API请求里的项目路径必须是完整的所有者/项目名格式（比如username/example或者organization/example），不能只传example，否则API无法定位到具体项目。

• 检查仓库名称的参数字段
  很多API里仓库名称对应的参数是name而不是你说的repos，如果你的请求里把仓库名放在repos字段里，API会识别不到，自然报错。一定要对照官方API文档里的请求体参数来传值。

• 权限与认证是否到位
  确保你使用的认证令牌（比如OAuth token）拥有足够的权限：如果是创建私有仓库需要repo权限，要是组织下的项目，还得确认令牌有组织的仓库创建权限。另外，认证头的格式要正确，比如Authorization: token YOUR_TOKEN，别写错格式。

• 避免仓库名重复
  检查目标项目（或对应的用户/组织）下是不是已经存在同名的仓库——哪怕是已经归档的私有仓库，也会导致创建失败，API通常会返回明确的“仓库已存在”提示。

• 请求格式是否正确
  必须用POST请求方法，同时要设置请求头Content-Type: application/json，不然API无法正确解析你传的JSON参数。

给你一个可行的示例代码（以GitHub API为例） #

用curl的话：

curl -X POST \
  -H "Authorization: token YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "your-repo-name",
    "description": "自定义仓库描述",
    "private": false
  }' \
  https://api.github.com/repos/your-username/example/repos

用Python requests库的话：

import requests

# 替换成你的令牌和项目信息
ACCESS_TOKEN = "your-access-token-here"
OWNER = "your-username"
PROJECT_NAME = "example"
REPO_NAME = "your-repo-name"

headers = {
    "Authorization": f"token {ACCESS_TOKEN}",
    "Content-Type": "application/json"
}

payload = {
    "name": REPO_NAME,
    "description": "测试创建子仓库",
    "private": False
}

response = requests.post(
    f"https://api.github.com/repos/{OWNER}/{PROJECT_NAME}/repos",
    json=payload,
    headers=headers
)

# 打印响应信息，方便排查错误
print(response.status_code)
print(response.json())

最后建议你仔细看API返回的错误响应体，里面的message字段会直接告诉你问题出在哪，比瞎猜高效多了！

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