ascend GitCode API
何时使用
查仓库/分支/议题/PR/提交/标签、用户与组织、搜索、Webhook、成员、发布等 GitCode 数据。全量 API 一览（每个接口的功能说明与可获取信息）见 reference.md，为本 skill 唯一 API 说明文档。
请求与认证
- Base URL：
https://api.gitcode.com/api/v5 - 认证：以下接口须带 Token（否则可能 400/401）：pulls、issues、branches、commits、仓库详情与文件列表、tags、releases、members、webhooks 等。
- Token 获取方式（按优先级）：
- 用户直接提供：用户可在问题中直接提供 token，如"获取 gitcode 上 owner/repo 仓库的 star 数量，token 是 xxxxx"
- 环境变量：从
GITCODE_TOKEN读取，顺序：(1) 当前进程$env:GITCODE_TOKEN（PowerShell）或$GITCODE_TOKEN（bash）；(2) Windows 用户变量[Environment]::GetEnvironmentVariable('GITCODE_TOKEN','User')；(3) Windows 系统变量[Environment]::GetEnvironmentVariable('GITCODE_TOKEN','Machine')
- 请求头：使用
PRIVATE-TOKEN: {token}或Authorization: Bearer {token}，或查询参数access_token={token} - 未配置时：提示用户到 GitCode 个人访问令牌 创建 Token（勾选 read_api、read_repository 等），并设置环境变量
GITCODE_TOKEN。
状态码与限流
| Code | 含义 |
|---|---|
| 200/201/204 | 成功 |
| 400 | 缺少参数或未带认证（部分接口） |
| 401 | Token 无效或缺失 |
| 403/404/409/422 | 禁止/未找到/冲突/校验失败 |
| 429 | 限流（默认 50/分钟、4000/小时） |
接口与示例
- 全量接口：所有 v5 接口的 Method / Path / 功能说明 / 可获取信息 / 官方文档链接见 reference.md（含 Repositories、Branch、Issues、Search、PR、Commit、Tag、Labels、Milestone、Users、Orgs、Webhooks、Member、Release 等）。
- 调用示例：见 examples.md。
- 官方文档：https://docs.gitcode.com/docs/apis/（每接口单独页含参数与响应）。
历史版本
v1.2.0 (2026-03-15)
- 🔒 移除
scripts/setup_gitcode_token.py
v1.1.0 (2026-03-14)
- 📝 优化 PR 评论 API 描述，区分普通评论与代码行评论
v1.0.0 (2026-03-11)
- 🎉 初始版本发布
- 🔍 支持仓库/分支/PR/提交/标签等 API 查询