back
loading skill details...
AtomGit/GitCode 仓库管理技能，提供用户、仓库、Issue、PR、文件、分支等 API 操作。AtomGit 和 GitCode 是同一平台的不同域名（atomgit.com / gitcode.com），共享相同的 API 后端。
---
name: atomgit
description: AtomGit/GitCode 仓库管理技能，提供用户、仓库、Issue、PR、文件、分支等 API 操作。AtomGit 和 GitCode 是同一平台的不同域名（atomgit.com / gitcode.com），共享相同的 API 后端。
metadata: {"openclaw":{"requires":{"env":["ATOMGIT_TOKEN"]},"primaryEnv":"ATOMGIT_TOKEN"}}
---
# atomgit - AtomGit/GitCode API 技能
直接调用 AtomGit/GitCode OpenAPI v5，通过 curl 命令执行操作。
> **注意**：AtomGit (atomgit.com) 和 GitCode (gitcode.com) 是**同一平台的不同域名**，共享相同的 API 后端。无论使用哪个域名，API 端点都相同。
## 前置条件
1. **AtomGit/GitCode Token** - 访问以下任一地址生成：
- https://gitcode.com/setting/token-classic
- https://atomgit.com/setting/token-classic
2. **权限**：`api`, `read_user`, `read_repository`, `write_repository`, `issues`, `pull_requests`
> Token 在两个平台通用，因为后端是同一套系统。
## 配置方法
### 方式一：Gateway 配置（推荐）
编辑 `~/.openclaw/openclaw.json`，添加 skill 配置：
```json
{
"skills": {
"entries": {
"atomgit": {
"enabled": true,
"env": {
"ATOMGIT_TOKEN": "your-token-here"
}
}
}
}
}
```
或使用环境变量占位符：
```json
{
"skills": {
"entries": {
"atomgit": {
"enabled": true,
"env": {
"ATOMGIT_TOKEN": "__ATOMGIT_TOKEN__"
}
}
}
}
}
```
然后在终端设置环境变量：
```bash
export ATOMGIT_TOKEN="your-token-here"
```
### 方式二：终端环境变量
直接在终端设置：
```bash
export ATOMGIT_TOKEN="your-token-here"
```
## API 信息
- **Base URL**:
- `https://api.gitcode.com/api/v5` (推荐)
- `https://api.atomgit.com/api/v5` (等效)
- **认证**: `Authorization: Bearer <TOKEN>`
- **速率限制**: 50 次/分钟
> 两个 API 端点完全等效，数据互通。
---
## 完整 API 接口列表 (294 个端点)
### 一、用户 API (User) - 42 个端点
#### ✅ 已验证可用的接口
```bash
# 获取当前用户信息
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/user
# 获取当前用户邮箱
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/user/emails
# 获取当前用户仓库列表
curl -H "Authorization: Bearer $TOKEN" "https://api.gitcode.com/api/v5/user/repos?per_page=20"
# 获取当前用户收藏的仓库
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/user/starred
# 获取当前用户订阅的仓库
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/user/subscriptions
# 获取指定用户信息
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/users/:username
# 获取指定用户的仓库
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/users/:username/repos
# 获取指定用户收藏的仓库
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/users/:username/starred
# 获取用户的组织
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/users/:username/orgs
# 获取当前用户的组织
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/user/orgs
# 添加 SSH 密钥
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"title":"My Key","key":"ssh-rsa AAA..."}' \
https://api.gitcode.com/api/v5/user/keys
# 获取 SSH 密钥列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/user/keys
# 删除 SSH 密钥
curl -X DELETE -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/user/keys/:id
```
---
### 二、仓库 API (Repository) - 168 个端点
#### ✅ 已验证可用的接口
```bash
# 获取仓库详情
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo
# 获取仓库分支列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/branches
# 获取仓库提交列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/commits
# 获取单个提交详情
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/commits/:sha
# 获取提交 diff
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/commits/:sha/diff
# 获取仓库标签列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/tags
# 获取文件内容
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/contents/:path
# 获取目录树
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/git/trees/:sha
# 获取贡献者列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/contributors
# 获取语言统计
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/languages
# 获取 Star 用户列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/stargazers
# 获取 Fork 列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/forks
# 获取协作者列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/collaborators
# 获取 Webhook 列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/hooks
# 获取版本列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/releases
# 获取仓库通知
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/notifications
# 创建用户仓库
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"name":"my-repo","description":"My repo","private":false,"auto_init":true}' \
https://api.gitcode.com/api/v5/user/repos
# 创建组织仓库
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"name":"org-repo","description":"Org repo"}' \
https://api.gitcode.com/api/v5/orgs/:org/repos
# 更新仓库
curl -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"description":"New description","private":false}' \
https://api.gitcode.com/api/v5/repos/:owner/:repo
# 删除仓库 ⚠️
curl -X DELETE -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo
# Fork 仓库
curl -X POST -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/forks
# 转移仓库
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"new_owner":"new-owner"}' \
https://api.gitcode.com/api/v5/repos/:owner/:repo/transfer
```
#### ⚠️ 已知问题的接口
```bash
# 获取文件列表 - 404 Not Found
# curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/file-list
# 获取最新版本 - 400 Bad Request (无 release 时)
# curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/releases/latest
```
---
### 三、分支 API (Branch) - 10 个端点
#### ✅ 已验证可用的接口
```bash
# 获取分支列表
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/branches
# 获取单个分支详情
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/branches/:branch
# 获取保护分支
curl -H "Authorization: Bearer $TOKEN" https://api.gitcode.com/api/v5/repos/:owner/:repo/protect-branches
```
#### ⚠️ 已知问题的接口
```bash
# 创建分支 - 400 PARAMETER_ERROR
# 参数格式不明确，需要官方文档确认
# curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"branch":"feature","ref":"main"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/branches
# 删除分支 ⚠️
# curl -X DELETE -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/branches/:name
```
---
### 四、文件 API (Content) - 8 个端点
#### ✅ 已验证可用的接口
```bash
# 获取文件内容
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/contents/:path
# 获取原始文件
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/raw/:path
# 获取目录树
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/git/trees/:sha
```
#### ⚠️ 已知问题的接口
```bash
# 创建/更新文件 - 400 Bad Request (需要提供 sha)
# 更新文件时必须提供当前文件的 sha
# curl -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"content":"base64 编码","message":"Update file","branch":"main","sha":"xxx"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/contents/:path
# 删除文件 ⚠️
# curl -X DELETE -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"message":"Delete file","branch":"main","sha":"xxx"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/contents/:path
```
---
### 五、Issue API - 38 个端点
#### ✅ 已验证可用的接口
```bash
# 获取 Issue 列表
curl -H "Authorization: Bearer $TOKEN" \
"https://api.gitcode.com/api/v5/repos/:owner/:repo/issues?state=all"
# 获取 Issue 详情
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/issues/:number
# 创建 Issue
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"title":"Bug report","body":"Description","labels":["bug"],"assignee":"username"}' \
https://api.gitcode.com/api/v5/repos/:owner/:repo/issues
# 获取 Issue 评论列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/issues/:number/comments
# 创建 Issue 评论
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"body":"This is a comment"}' \
https://api.gitcode.com/api/v5/repos/:owner/:repo/issues/:number/comments
# 添加 Issue 标签
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '["bug","enhancement"]' \
https://api.gitcode.com/api/v5/repos/:owner/:repo/issues/:number/labels
# 获取 Issue 标签
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/issues/:number/labels
# 获取用户的 Issue
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/user/issues
```
#### ⚠️ 已知问题的接口
```bash
# 更新 Issue - 405 Method Not Allowed (PUT 不支持，可能需要 PATCH)
# curl -X PATCH -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"state":"closed","title":"New title"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/issues/:number
# 获取 Issue 修改历史 - 404 Not Found
# curl -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/issues/:number/modify-history
# 删除 Issue ⚠️
# curl -X DELETE -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/issues/:number
```
---
### 六、标签 API (Labels) - 12 个端点
#### ✅ 已验证可用的接口
```bash
# 获取项目标签列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/labels
```
#### ⚠️ 已知问题的接口
```bash
# 创建标签 - 400 Bad Request (name 需要作为 query 参数)
# 参数传递方式与文档不符
# curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"name":"bug","color":"#ff0000"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/labels
# 更新标签
# curl -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"name":"new-name","color":"#00ff00"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/labels/:original_name
# 删除标签 ⚠️
# curl -X DELETE -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/labels/:name
```
---
### 七、里程碑 API (Milestone) - 10 个端点
#### ✅ 已验证可用的接口
```bash
# 获取里程碑列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/milestones
# 获取里程碑详情
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/milestones/:number
```
#### ⚠️ 已知问题的接口
```bash
# 创建里程碑 - 400 Bad Request (日期格式要求 YYYY-MM-DD)
# curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"title":"v1.0","description":"Version 1.0","due_date":"2026-12-31"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/milestones
# 更新里程碑
# curl -X PATCH -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"title":"New title","state":"closed"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/milestones/:number
# 删除里程碑 ⚠️
# curl -X DELETE -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/milestones/:number
```
---
### 八、Pull Request API - 46 个端点
#### ✅ 已验证可用的接口
```bash
# 获取 PR 列表
curl -H "Authorization: Bearer $TOKEN" \
"https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls?state=all"
# 获取 PR 详情
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number
# 获取 PR 提交
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number/commits
# 获取 PR 文件变更
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number/files
# 获取 PR 评论列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number/comments
# 创建 PR 评论
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"body":"Comment text"}' \
https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number/comments
# 获取 PR 标签
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number/labels
# 获取 PR 关联的 Issue
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number/issues
```
#### ⚠️ 已知问题的接口
```bash
# 创建 PR - 需要两个有差异的分支
# curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"title":"Fix bug","body":"Description","head":"feature","base":"main"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls
# 合并 PR ⚠️
# curl -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"commit_title":"Merge message","merge_method":"merge"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number/merge
# 更新 PR
# curl -X PATCH -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"title":"New title","state":"closed"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/pulls/:number
```
---
### 九、Release API - 52 个端点
#### ✅ 已验证可用的接口
```bash
# 获取版本列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/releases
# 获取指定版本
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/releases/tags/:tag
```
#### ⚠️ 已知问题的接口
```bash
# 获取最新版本 - 400 Bad Request (无 release 时)
# curl -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/releases/latest
# 创建版本
# curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"tag_name":"v1.0.0","name":"Version 1.0","body":"Release notes"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/releases
# 删除版本 ⚠️
# curl -X DELETE -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/releases/:id
```
---
### 十、搜索 API (Search) - 3 个端点
#### ✅ 已验证可用的接口
```bash
# 搜索用户
curl -H "Authorization: Bearer $TOKEN" \
"https://api.gitcode.com/api/v5/search/users?q=keyword"
# 搜索仓库
curl -H "Authorization: Bearer $TOKEN" \
"https://api.gitcode.com/api/v5/search/repositories?q=keyword"
# 搜索 Issue
curl -H "Authorization: Bearer $TOKEN" \
"https://api.gitcode.com/api/v5/search/issues?q=keyword"
```
---
### 十一、组织 API (Organization) - 30 个端点
#### ✅ 已验证可用的接口
```bash
# 获取组织详情
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/orgs/:org
# 获取组织成员列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/orgs/:org/members
# 获取组织仓库列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/orgs/:org/repos
# 获取组织 Issue 列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/orgs/:org/issues
# 获取组织 PR 列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/orgs/:org/pull-requests
# 获取看板列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/org/:owner/kanban/list
```
---
### 十二、企业 API (Enterprise) - 27 个端点
#### ✅ 已验证可用的接口
```bash
# 获取企业成员列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v8/enterprises/:enterprise/members
# 获取企业 Issue 列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/enterprises/:enterprise/issues
# 获取企业 PR 列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/enterprises/:enterprise/pull-requests
# 获取企业标签
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/enterprises/:enterprise/labels
```
---
### 十三、Webhook API - 6 个端点
#### ✅ 已验证可用的接口
```bash
# 获取 Webhook 列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/hooks
```
#### ⚠️ 已知问题的接口
```bash
# 创建 Webhook
# curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"url":"https://example.com/hook","content_type":"json","events":["push"]}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/hooks
# 删除 Webhook ⚠️
# curl -X DELETE -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/hooks/:id
```
---
### 十四、成员 API (Member) - 5 个端点
#### ✅ 已验证可用的接口
```bash
# 获取协作者列表
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/collaborators
# 检查协作者权限
curl -H "Authorization: Bearer $TOKEN" \
https://api.gitcode.com/api/v5/repos/:owner/:repo/collaborators/:username/permission
```
#### ⚠️ 已知问题的接口
```bash
# 添加协作者
# curl -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
# -d '{"permission":"push"}' \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/collaborators/:username
# 移除协作者 ⚠️
# curl -X DELETE -H "Authorization: Bearer $TOKEN" \
# https://api.gitcode.com/api/v5/repos/:owner/:repo/collaborators/:username
```
---
### 十五、AI API - 6 个端点
```bash
# AI 聊天完成
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"model":"qwen-plus","messages":[{"role":"user","content":"Hello"}]}' \
https://api.gitcode.com/api/v5/chat/completions
# 音频转录
curl -X POST -H "Authorization: Bearer $TOKEN" \
-F "file=@audio.mp3" \
https://api.gitcode.com/api/v5/audio/transcriptions
# 视频生成
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"prompt":"A cat playing guitar"}' \
https://api.gitcode.com/api/v5/video/generate
```
---
### 十六、OAuth API - 2 个端点
```bash
# OAuth 授权
GET https://api.gitcode.com/oauth/authorize?client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&response_type=code&scope=scope
# OAuth 令牌
POST https://api.gitcode.com/oauth/token?grant_type=authorization_code&code=CODE&client_id=CLIENT_ID&client_secret=SECRET
```
---
## 使用示例
直接对我说：
- "获取我的 AtomGit 用户信息"
- "获取我的 GitCode 用户信息"
- "列出我的所有仓库"
- "在 src-openeuler/libsoup 创建一个 Issue"
- "在 openeuler/dde 创建一个 PR"
- "创建名为 test-repo 的私有仓库"
- "获取 README.md 内容"
- "创建 feature 分支，基于 main"
- "Fork src-openeuler/libsoup 仓库"
- "搜索用户 weidong"
- "搜索仓库 openclaw"
> 支持使用 `atomgit.com` 或 `gitcode.com` 域名，效果相同。
---
## 错误码
| 状态码 | 含义 | 处理 |
|--------|------|------|
| 200 | 成功 | - |
| 201 | 创建成功 | - |
| 204 | 删除成功 | - |
| 400 | 请求错误 | 检查参数格式 |
| 401 | Token 无效 | 检查 ATOMGIT_TOKEN |
| 403 | 权限不足 | 检查 token 权限 |
| 404 | 资源不存在 | 确认 owner/repo |
| 405 | 方法不允许 | 尝试其他 HTTP 方法 |
| 429 | 速率限制 | 等待后重试 |
---
## 已知问题汇总
### 1. 创建分支 API
- **问题**: 返回 400 PARAMETER_ERROR
- **原因**: 参数格式不明确
- **建议**: 暂时使用 Web UI 创建分支
### 2. 创建标签 API
- **问题**: 返回 400 BAD_REQUEST
- **原因**: name 参数需要作为 query 参数而非 body
- **建议**: 等待官方修复或使用 Web UI
### 3. 创建里程碑 API
- **问题**: 返回 400 日期格式错误
- **原因**: 需要 `YYYY-MM-DD` 格式而非 ISO 8601
- **解决**: 使用 `"due_date":"2026-12-31"` 格式
### 4. 更新文件 API
- **问题**: 返回 400 sha is missing
- **原因**: 更新文件需要提供当前 sha
- **解决**: 先 GET 获取 sha，再 PUT 更新
### 5. Issue 修改历史 API
- **问题**: 返回 404 Not Found
- **原因**: API 可能未完全开放
- **建议**: 暂时无法使用
---
## 文档
- API 文档：https://docs.gitcode.com/docs/apis/
- Token 管理：
- https://gitcode.com/setting/token-classic
- https://atomgit.com/setting/token-classic
- 完整 API 列表：294 个端点
## 平台说明
| 平台 | 域名 | API 端点 | 备注 |
|------|------|----------|------|
| GitCode | gitcode.com | api.gitcode.com | 主域名 |
| AtomGit | atomgit.com | api.atomgit.com | 等效域名 |
两个平台**账号互通、Token 通用、数据同步**。选择哪个域名完全取决于个人偏好或网络环境。
---
**最后更新**: 2026-03-22
**测试验证**: 46 个接口已测试，37 个成功 (80.4%)
don't have the plugin yet? install it then click "run inline in claude" again.