用户¶

用户相关的接口覆盖个人资料、邮箱与公钥、Namespace、Star 与 Watch、通知，以及以当前令牌身份查询「我」的仓库和 Pull Request。

同一个资源通常有两个版本：/user/… 指当前授权用户，/users/{username}/… 指指定用户，权限与返回范围不同。

对象¶

标识方式¶

• 指定用户用 username 标识，授权用户直接用 /user，不带参数。
• 仓库沿用 owner + repo，其中仓库归属可以用 owner 也可以用组织或企业路径。
• 公钥用 id 标识，通知按 owner + repo 定位。

常见任务¶

注意事项¶

• /user/… 与 /users/{username}/… 是两套接口：前者只作用于当前令牌对应的账号，后者可查任意用户的公开数据，别拿前者当通用查询。
• Namespace 有单复数两个接口：GET /api/v5/user/namespaces 是列表，GET /api/v5/user/namespace 取单个，路径差一个 s。
• 邮箱接口是 GET /api/v5/emails，不带 user 前缀。
• 「列出授权用户所属的组织」在组织分组里，且它的路径是 GET /api/v5/users/orgs（没有 {username}），与 GET /api/v5/users/{username}/orgs 是两个不同接口。
• 通知只按仓库维度提供，没有跨仓库的通知列表接口。

接口列表¶

本模块共 22 个接口。