常见问题导读
常见问题的四大类划分、按现象与错误码检索的方式,以及它与错误码页的分工。
常见问题收的是已经被问到过的问题:普通用户在授权页前的疑惑,和开发者在联调时的卡点。它不追求系统性,追求「照着做能解决」。
本页说明这个板块怎么用、和错误码页怎么分工。
四大类
| 读者 | 关心什么 | 类别 |
|---|---|---|
| 普通用户 | 密码、验证方式、登录会话、账号被别人用过 | 账号与安全 |
| 普通用户 | 为什么被要求重新登录、为什么要求再验证一次 | 登录与验证 |
| 普通用户、开发者 | 授权页在问什么、取消授权后怎样、scope 与受众 | 授权与权限 |
| 开发者 | 为什么报这个错、scope 为什么少了、密钥能不能放前端 | 接入与联调 |
用户侧的答案不用懂任何术语,开发者侧的答案默认你知道 client_id 是什么。不确定该看哪一类时,从常见问题总览进入。
怎么检索
按顺序尝试,越往后越具体:
与错误码页的分工
| 页面 | 回答的问题 |
|---|---|
| 错误码 | 这个错误码的判定依据是什么,按什么顺序排查 |
| 常见问题 | 这个场景下通常是什么原因,怎么改 |
错误码页是完整的、按协议组织的;常见问题是经验性的、按场景组织的。两者说法冲突时,以错误码页为准。
四类速览
每一类都有自己的总览页,列出这一类回答哪些问题、以及什么不属于这一类:
没找到答案
按「文档写错了」来报,而不是自己绕过:绕过会留下一个长期隐患,写错了会被修正。文档的变更说明与反馈口径见文档纲要。