接入指南导读
接入指南覆盖的四组内容、页面之间的依赖关系、建议的三步顺序，以及读完能做到什么、不包含什么。
接入指南是给第一次接入的第三方应用准备的：从申请凭证到拿到第一个可用令牌，每一步都能单独验证。它不讲协议史，也不讲内部实现，只讲「你该做什么、做完怎么确认」。
本页说明这个板块装了什么、页面之间是什么关系、按什么顺序读。
覆盖范围
| 分组 | 页面 | 解决的问题 |
|---|---|---|
| 接入准备 | 申请客户端、快速开始、元数据发现 | 拿到 client_id，认全端点，跑通一次完整流程 |
| 授权流程 | 授权码流程、令牌端点、令牌交换 | 从浏览器跳转到令牌落地的每一步细节 |
| 权限与安全 | Scope 与受众、回调地址规则、认证强度、细粒度授权 | 拿到令牌之后，边界在哪里 |
| 参考 | 端点总表、令牌结构、错误码 | 需要查表时直接翻，不必顺序读 |
页面之间的关系
授权码流程是主轴，其余页面都挂在它上面：
另外两页是横切的，随时可查：元数据发现 决定你代码里的端点从哪来，错误码 决定你出错时先看哪。
建议顺序
| 阶段 | 做什么 | 读哪些 |
|---|---|---|
| 先跑通 | 十五分钟内走完一次授权码流程，拿到令牌并调用 UserInfo | 申请客户端 → 快速开始 |
| 再做扎实 | 补齐 PKCE 校验、回调白名单、令牌校验与刷新 | 授权码流程 → 令牌端点 → 令牌结构 |
| 最后划边界 | 确认请求的 scope 与受众、处理提权与拒绝 | Scope 与受众 → 回调地址规则 → 认证强度 |
不要跳过第一阶段直接读第三阶段。安全边界的很多结论，只有在你亲手跑过一次流程之后才读得懂——没跑过时，「受众不对」只是四个字；跑过之后，它是一个你见过的 401。
读完能做到什么
- 你的应用能用 MuoCeon 账号登录，并拿到可校验的令牌；
- 你知道每个参数为什么必填、每个错误码意味着哪一步失败；
- 你知道哪些能力对第三方不开放（令牌交换、细粒度授权），不会花时间尝试。
不包含什么
- 开发者平台的操作指引：平台尚未上线，申请目前走人工登记，流程见申请客户端；
- MuoCeon 的内部实现：不写表结构、缓存键、内部调用链；
- 非 OAuth 的账号接口（账户资料、授权记录管理）：属于 API 文档板块，见 API 文档导读；
- 面向普通用户的说明：授权页在问什么、怎么取消授权，见 常见问题导读。
常见误区
| 误区 | 实际情况 |
|---|---|
| 把示例里的域名抄进代码 | 域名随部署变化，端点应从元数据发现读取 |
| 以为请求的 scope 都会拿到 | 服务端按客户端能力静默裁剪，以响应里的 scope 为准 |
| 想用隐式流程或密码模式图省事 | 第三方只有授权码 + PKCE（S256）一条路，其余直接拒绝 |
移动端把 client_secret 打进包里 | 无密钥客户端就按 web_client / desktop 登记，密钥不进客户端 |