用户操作
用户操作端点支持评论议题、合并 PR 和添加反应。所有操作端点都需要来自 OAuth 流程的有效 Bearer Token。
鉴权
所有操作端点都需要 Authorization 头:
Authorization: Bearer <github-access-token>如果 Token 缺失或无效,端点返回 401。
端点
评论议题
POST /api/comment在议题或拉取请求上创建评论。
请求体:
json
{
"owner": "org",
"repo": "repo",
"issueNumber": 42,
"body": "评论内容"
}| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
owner | string | 是 | 仓库所有者 |
repo | string | 是 | 仓库名称 |
issueNumber | number | 是 | 议题或 PR 编号 |
body | string | 是 | 评论内容(支持 Markdown) |
响应: 200 与 GitHub API 响应。
合并拉取请求
POST /api/merge合并拉取请求。
请求体:
json
{
"owner": "org",
"repo": "repo",
"pullNumber": 42,
"mergeMethod": "squash"
}| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
owner | string | 是 | 仓库所有者 |
repo | string | 是 | 仓库名称 |
pullNumber | number | 是 | 拉取请求编号 |
mergeMethod | string | 否 | merge、squash 或 rebase(默认:merge) |
响应: 200 与 GitHub 合并响应。
添加反应
POST /api/react为议题或评论添加表情反应。
请求体:
json
{
"owner": "org",
"repo": "repo",
"issueNumber": 42,
"content": "rocket"
}| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
owner | string | 是 | 仓库所有者 |
repo | string | 是 | 仓库名称 |
issueNumber | number | 是 | 议题、PR 或评论编号 |
content | string | 是 | 反应类型(见下方) |
反应类型:
+1、-1、laugh、confused、heart、hooray、rocket、eyes
响应: 200 与 GitHub 反应响应。
错误响应
| 状态码 | 响应体 | 原因 |
|---|---|---|
401 | {"error": "Unauthorized"} | 缺少或无效的 Bearer Token |
400 | {"error": "..."} | 无效的请求体 |
500 | {"error": "..."} | GitHub API 错误 |