首次接入 SDK 报错应该排查哪些接口

如果刚接入 SDK，创建或打开文档时频繁出现 10002 获取指定文件信息 404、10003 获取当前用户信息 404，说明核心回调接口尚未就绪。最小可用集至少包含：

GET /files/{fileId}（协同文档元信息）：返回文档名称、类型、owner、permissions（readable=true 必填）、下载地址/扩展名等。缺失任何必填字段都可能触发 10002。

GET /users/current/info：根据 X-Shimo-Token 识别当前业务用户并返回 id/name/avatar，缺少则触发 10003。

如果需要 @ 功能或协作列表，还要实现 /files/{fileId}/collaborators、/search/users/recent 等接口；未实现但被前端调用，也会在日志里看到 10005～10009。

排查方式：

在 Apifox/脚本里用与 SDK 相同的签名和 Header 手工调用一次，确认接口可直接返回；

在网关记录石墨发出的请求，确认 URL、Header、Body 未被防火墙拦截；

校验 X-Shimo-Signature，确保请求确实来自石墨。

只要上述接口返回 200 且结构符合文档要求，这类 1000x 错误便可消除。

首次接入 SDK 报错 应该排查哪些接口