仓库¶

仓库用于存放代码、模型、数据集等内容。通过 API 可以创建、更新、转移和归档仓库，读写文件，Fork 仓库并与源仓库同步，配置仓库设置与成员权限，并查看贡献者、动态和下载统计。

分支、标签、提交、Release、Webhook 有独立的分组，本页不重复列出。

对象¶

标识方式¶

• 仓库用路径参数 owner 和 repo 标识：owner 是仓库所属空间地址（企业、组织或个人的 path），repo 是仓库路径。
• 文件用路径参数 path 标识，即文件在仓库中的路径。
• 更新文件、删除文件时需要文件当前的 Blob SHA，可通过 获取仓库具体路径下的内容 拿到。
• 归档、转移等少数接口用 org + repo 或 org + projects 标识，路径不以 /repos/ 开头。

常见任务¶

注意事项¶

• 归档、转移有一组接口的路径以 /org/ 开头，与其他 /repos/{owner}/{repo}/… 接口不同：归档是 PUT /api/v5/org/{org}/repo/{repo}/status，转移另有 POST /api/v5/org/{org}/projects/{repo}/transfer，而 POST /api/v5/repos/{owner}/{repo}/transfer 是另一种转移入口，调用前先确认目标空间类型。
• 「更新仓库设置」有两个不同接口，按用途区分：PATCH /api/v5/repos/{owner}/{repo} 改名称、描述、默认分支、可见性等基本信息；PUT /api/v5/repos/{owner}/{repo}/repo_settings 改仓库设置项。
• 新建与更新文件时 content 需使用 Base64 编码；更新和删除还要带原文件的 Blob SHA，否则会冲突。
• 上传附件（POST /api/v5/repos/*/*/file/upload）大小上限为 20M，路径里用 * 占位而不是 {owner}/{repo}。
• 上传图片与上传附件是两个不同接口，返回值分别用于页面插图与附件下载，别混用。

接口列表¶

本模块共 44 个接口。