-
- {`const authUrl = 'https://connect.q58.club/oauth/authorize?' +
+
+ {/* */}
+
+
+
+
+
+ 1
+
+
+ 发起OAuth授权请求
+
+ 构建授权URL并重定向用户到授权页面
+
+
+
+
+
+
+ 请求地址
+
+ GET https://connect.q58.club/oauth/authorize
+
+
+
+
+ 请求参数
+
+ {`const authUrl = 'https://connect.q58.club/oauth/authorize?' +
new URLSearchParams({
- response_type: 'code', // 必填，固定值
+ response_type: 'code', // 必填，固定值为"code"
client_id: 'your_client_id', // 必填，您的应用ID
- redirect_uri: 'https://your-app.com/callback',
- state: 'random_state', // 建议提供，防CSRF攻击
- scope: 'read_profile' // 可选，默认read_profile
+ redirect_uri: 'https://your-app.com/callback', // 必填，回调地址
+ scope: 'read_profile' // 可选，权限范围，默认read_profile
});
window.location.href = authUrl;`}
-
-
-
-
-
-
-
-
- 2. 处理授权回调
-
- 在回调地址处理授权结果
-
-
-
-
-
- {`// 获取访问令牌
-const response = await fetch('https://connect.q58.club/api/oauth/access_token', {
+
+
+
+
+ 授权响应
+
+
+ 用户授权后，将重定向到您的回调地址：
+
+
+
+ https://your-app.com/callback?code=ac_xxxxxx...
+
+
+
+ 授权码说明：
+
+ - 格式：ac_前缀 + 40位随机字符
+ - 有效期：10分钟
+ - 使用限制：仅可使用一次
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 2
+
+
+ 使用授权码交换访问令牌
+
+ 在服务器端使用授权码换取访问令牌
+
+
+
+
+
+
+ 请求地址
+
+ POST
+ https://connect.q58.club/api/oauth/access_token
+
+
+
+
+ 请求示例
+
+ {`const response = await fetch('https://connect.q58.club/api/oauth/access_token', {
method: 'POST',
headers: {
- 'Content-Type': 'application/x-www-form-urlencoded'
+ 'Content-Type': 'application/x-www-form-urlencoded',
+ 'Authorization': 'Basic ' + btoa(client_id + ':' + client_secret)
},
body: new URLSearchParams({
- code: '授权码', // 回调参数中的code
- redirect_uri: 'https://your-app.com/callback'
+ code: 'ac_xxxxx', // 必填，授权码
+ redirect_uri: 'https://your-app.com/callback' // 必填，与请求授权码时相同
})
-});
+});`}
+
+
-const { access_token, expires_in } = await response.json();`}
-
-
-
-
-
-
-
-
- 3. 获取用户信息
-
- 使用访问令牌获取用户数据
-
-
-
-
-
- {`const userInfo = await fetch('https://connect.q58.club/api/oauth/user', {
- headers: {
- 'Authorization': \`Bearer \${access_token}\`
- }
-}).then(res => res.json());
-
-// 返回数据示例:
-{
- "id": "user_xxx",
- "email": "user@example.com",
- "username": "username",
- "name": "用户昵称",
- "avatar_url": "https://...",
- "groups": ["group1", "group2"]
+
+ 响应数据
+
+
+
+ {`{
+ "access_token": "at_xxxxxxxx", // 访问令牌
+ "token_type": "bearer", // 令牌类型，固定为bearer
+ "expires_in": 604800 // 令牌有效期，单位秒（7天）
}`}
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 3
+
+
+ 获取用户信息
+
+ 使用访问令牌获取已授权用户的详细信息
+
+
+
+
+
+
+ 请求地址
+
+ GET https://connect.q58.club/api/oauth/user
+
+
+
+
+ 请求示例
+
+ {`const userInfo = await fetch('https://connect.q58.club/api/oauth/user', {
+ headers: {
+ 'Authorization': \`Bearer \${access_token}\` // 使用获取到的访问令牌
+ }
+}).then(res => res.json());`}
+
+
+
+
+ 响应数据
+
+
+
+ {`{
+ "id": "user_xxx", // 用户唯一标识
+ "email": "user@example.com",// 邮箱地址
+ "username": "username", // 用户名
+ "name": "用户昵称", // 显示名称
+ "avatar_url": "https://...",// 头像URL
+ "admin": false, // 是否管理员
+ "groups": ["group1"], // 用户组
+}`}
+
+
+
+
+
+
+
+
+ {children}
+
+