跳到正文
MuoCeon 文档中心

常见问题导读

常见问题的四大类划分、按现象与错误码检索的方式,以及它与错误码页的分工。

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

本页说明这个板块怎么用、和错误码页怎么分工。

四大类

读者关心什么类别
普通用户密码、验证方式、登录会话、账号被别人用过账号与安全
普通用户为什么被要求重新登录、为什么要求再验证一次登录与验证
普通用户、开发者授权页在问什么、取消授权后怎样、scope 与受众授权与权限
开发者为什么报这个错、scope 为什么少了、密钥能不能放前端接入与联调

用户侧的答案不用懂任何术语,开发者侧的答案默认你知道 client_id 是什么。不确定该看哪一类时,从常见问题总览进入。

怎么检索

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

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

与错误码页的分工

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

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

四类速览

每一类都有自己的总览页,列出这一类回答哪些问题、以及什么不属于这一类:

没找到答案

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

本页目录