Skip to content

Commit 27b5125

Browse files
committed
✨ feat(oauth): add scopes.md
1 parent 1a2c3e4 commit 27b5125

File tree

1 file changed

+62
-0
lines changed

1 file changed

+62
-0
lines changed

docs/advanced/oauth2/scopes.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
outline: [2, 3]
3+
---
4+
# OAuth2 作用域 <Badge type="warn" text="测试页面" />
5+
6+
本页面列出了 LittleSkin 支持的 OAuth2 作用域(scope),以及它们的用途和注解。
7+
8+
---
9+
10+
[[toc]]
11+
12+
## 一般权限
13+
### `openid`
14+
OpenID Connect 标准作用域
15+
16+
获取 ID 令牌(ID Token)时必须使用
17+
18+
### `offline_access`
19+
获取刷新令牌(Refresh Token)
20+
21+
刷新令牌可用于请求新的访问令牌
22+
23+
### `User.Read`
24+
读取用户基本信息
25+
26+
### `Player.Read` / `Player.ReadWrite`
27+
读取 / 读写用户的角色和对应材质
28+
29+
### `Closet.Read` / `Closet.ReadWrite`
30+
读取 / 读写用户的衣柜收藏
31+
32+
### `Notification.Read`
33+
读取用户的站内通知
34+
35+
### `PremiumVerification.Read`
36+
读取用户正版验证状态
37+
38+
## Yggdrasil 权限
39+
40+
> [!WARNING] ⛔ 存在冲突
41+
>
42+
> [`Yggdrasil.PlayerProfiles.Read`](#yggdrasil-playerprofiles-read)[`Yggdrasil.PlayerProfiles.Select`](#yggdrasil-playerprofiles-select) 冲突,**不可同时使用**
43+
>
44+
> 若同时使用这两个权限:
45+
>
46+
> - 在设备代码流中,LittleSkin 将返回 `invalid_scope` 错误
47+
> - 在授权代码流中,用户将正常完成授权,但在请求 API 时可能会返回错误
48+
49+
### `Yggdrasil.PlayerProfiles.Read`
50+
读取用户的所有 Yggdrasil 档案
51+
52+
应用将得到用户的 **所有** Yggdrasil 档案
53+
54+
### `Yggdrasil.PlayerProfiles.Select`
55+
要求在用户授权时将要求用户选择角色
56+
57+
应用将得到 **一个** 被选择的角色的 Yggdrasil 档案
58+
59+
### `Yggdrasil.Server.Join`
60+
加入 Minecraft 多人游戏服务器
61+
62+
必须同时申请 `Yggdrasil.PlayerProfiles.Select`

0 commit comments

Comments
 (0)