OAuth

WebHooker 实现 GitHub OAuth2 以支持用户发起的操作（评论、合并、反应）。

流程

text

用户 → GET /auth/github → 重定向到 GitHub → 授权 →
  → GET /auth/github/callback → 交换 code 获取 Token → 存储到 KV

端点

启动 OAuth

GET /auth/github

将用户重定向到 GitHub 的授权页面。

查询参数：

参数	说明
`userId`	你的应用用户标识符

响应： 302 重定向到 GitHub OAuth 授权 URL。

OAuth 回调

GET /auth/github/callback

GitHub 授权后重定向到此地址。将 code 交换为访问令牌并存储到 KV。

查询参数（来自 GitHub）：

参数	说明
`code`	授权码
`state`	CSRF 保护的状态参数

响应： 重定向到你的 BASE_URL，附带成功/失败指示。

撤销 Token

DELETE /auth/token/:userId

删除用户存储的 OAuth Token。

响应：

json

{
  "ok": true
}

Token 存储

Token 以键模式 token:{userId} 存储在 KV 中：

json

{
  "accessToken": "gho_...",
  "expiresAt": "2025-01-01T00:00:00.000Z"
}

Token 会根据 expiresAt 时间戳自动过期。

使用 Token

OAuth 完成后，在操作 API 调用的 Authorization 头中包含访问令牌：

bash

curl -X POST https://your-worker/api/comment \
  -H "Authorization: Bearer gho_..." \
  -H "Content-Type: application/json" \
  -d '{"owner": "org", "repo": "repo", "issueNumber": 1, "body": "你好！"}'

OAuth ​

流程 ​

端点 ​

启动 OAuth ​

OAuth 回调 ​

撤销 Token ​

Token 存储 ​

使用 Token ​