常见问题总览
常见问题按四类划分(账号与安全、登录与验证、授权与权限、接入与联调),以及按现象、错误码、字段的检索顺序。
常见问题收的是已经被问到过的问题:普通用户在授权页前的疑惑,和开发者在联调时的卡点。它不追求系统性,追求「照着做能解决」。
本页说明分类方式与检索顺序。
分类
| 类别 | 回答什么 | 适合谁 |
|---|---|---|
| 账号与安全 | 密码与找回、验证方式、登录会话、账号被他人使用 | 普通用户 |
| 登录与验证 | 为什么被要求重新登录、为什么要求再验证一次 | 普通用户 |
| 授权与权限 | 授权页在问什么、取消授权后会发生什么、scope 与受众 | 普通用户、开发者 |
| 接入与联调 | 申请客户端、回调地址、授权码换令牌、令牌校验 | 开发者 |
四类之间按「问题出在谁身上」划分,而不是按页面划分:账号自身状态的问题在账号与安全,登录过程的问题在登录与验证,应用与应用之间的授权在授权与权限,开发者侧的联调在接入与联调。
怎么检索
按顺序尝试,越往后越具体:
与错误码页的分工
| 页面 | 回答的问题 |
|---|---|
| 错误码 | 这个错误码的判定依据是什么,按什么顺序排查 |
| 常见问题 | 这个场景下通常是什么原因,怎么改 |
错误码页是完整的、按协议组织的;常见问题是经验性的、按场景组织的。两者说法冲突时,以错误码页为准。
没找到答案
按「文档写错了」来报,而不是自己绕过:绕过会留下一个长期隐患,写错了会被修正。文档的变更说明与反馈口径见文档纲要。