用途:通过 GitCode 平台的 REST API 获取和查询数据,覆盖仓库、分支、议题(issues)、拉取请求(PR)、提交、标签、用户与组织、搜索、Webhook、成员、发布等。全量接口的功能说明与可获取信息见 reference.md,调用示例见 examples.md,官方文档为 https://docs.gitcode.com/docs/apis/。
主要能力:查询仓库详情与文件列表、分支、议题、PR、提交、标签、发布、成员、Webhook,以及用户、组织与搜索等。
使用方式:Base URL 为 https://api.gitcode.com/api/v5。部分接口(pulls、issues、branches、commits、仓库详情与文件列表、tags、releases、members、webhooks 等)须带 Token,否则可能返回 400/401。Token 获取优先级:用户直接提供;或从环境变量 GITCODE_TOKEN 读取,顺序为当前进程 $env:GITCODE_TOKEN(PowerShell)或 $GITCODE_TOKEN(bash)、Windows 用户变量、Windows 系统变量。请求头可用 PRIVATE-TOKEN: {token} 或 Authorization: Bearer {token},也可用查询参数 access_token={token}。未配置时提示用户到 GitCode 个人访问令牌创建 Token(勾选 read_api、read_repository 等)并设置环境变量 GITCODE_TOKEN。
状态码与限流:200/201/204 成功;400 缺少参数或未带认证;401 Token 无效或缺失;403/404/409/422 分别表示禁止、未找到、冲突、校验失败;429 为限流,默认 50/分钟、4000/小时。
限制:具体接口参数与响应以官方文档为准;Token 权限与限流会影响可用性;资料未提供更多平台或收费信息。