跳到正文
MuoCeon 文档中心

常见问题总览

常见问题按四类划分(账号与安全、登录与验证、授权与权限、接入与联调),以及按现象、错误码、字段的检索顺序。

常见问题收的是已经被问到过的问题:普通用户在授权页前的疑惑,和开发者在联调时的卡点。它不追求系统性,追求「照着做能解决」。

本页说明分类方式与检索顺序。

分类

类别回答什么适合谁
账号与安全密码与找回、验证方式、登录会话、账号被他人使用普通用户
登录与验证为什么被要求重新登录、为什么要求再验证一次普通用户
授权与权限授权页在问什么、取消授权后会发生什么、scope 与受众普通用户、开发者
接入与联调申请客户端、回调地址、授权码换令牌、令牌校验开发者

四类之间按「问题出在谁身上」划分,而不是按页面划分:账号自身状态的问题在账号与安全,登录过程的问题在登录与验证,应用与应用之间的授权在授权与权限,开发者侧的联调在接入与联调。

怎么检索

按顺序尝试,越往后越具体:

  1. 按现象找:看到的现象(授权页没弹、回调 404、令牌 401)直接对应条目;
  2. 按错误码找:错误码 给的是排查顺序,常见问题给的是结论;
  3. 按字段找:API 文档 给的是参数与约束。

与错误码页的分工

页面回答的问题
错误码这个错误码的判定依据是什么,按什么顺序排查
常见问题这个场景下通常是什么原因,怎么改

错误码页是完整的、按协议组织的;常见问题是经验性的、按场景组织的。两者说法冲突时,以错误码页为准。

没找到答案

按「文档写错了」来报,而不是自己绕过:绕过会留下一个长期隐患,写错了会被修正。文档的变更说明与反馈口径见文档纲要。

本页目录