开放 API 用于让第三方应用更自然地接入 fnOS。应用可以在自己的页面里完成文件授权、打开系统页面、读取界面语言和主题，也可以在后端查询授权结果、检查文件权限和转换路径。
INFO
这是系统能力开放的第一期内容，当前重点放在文件授权、页面路由、界面状态和后端查询等基础能力上。后续我们会继续探索更多系统能力的开放，让应用可以在保持安全边界的前提下，更深入地和 fnOS 协同。
这套能力的目标不是绕过系统权限，而是在应用体验和系统安全之间取得平衡：
- 提升应用交互体验：用户不必频繁离开应用页面去系统设置中手动授权，可以在当前应用流程里完成目录或文件选择。
- 保持权限边界清晰：应用访问用户文件前仍需要用户或管理员明确授权；拿到授权路径后，也不能绕过当前用户的文件权限。
- 支持多用户使用场景：应用可以结合统一网关识别当前使用用户，再按用户查询授权目录或检查文件权限，为不同用户提供不同内容。
- 复用系统页面能力：应用可以打开文件、文件管理器、文件详情、应用设置或外部链接，减少重复实现系统已有功能。
- 适配宿主界面状态：应用可以读取当前语言、主题和系统版本，并在 Web 宿主环境中监听语言或主题变化，让界面更贴近系统体验。
你可以用这些能力完成下面几类工作：
- 让管理员为应用授权一个固定目录。
- 让当前用户在应用内选择并授权自己的目录或文件。
- 在后端查询授权结果，并按用户检查文件权限。
- 在应用页面中打开文件、文件管理器、应用设置或外部链接。
- 读取宿主界面语言、主题；在 Web 宿主环境中监听语言或主题变化。
阅读顺序
- 先阅读 调用方式，完成
api-scope、JS SDK 和后端 API 的基础接入。 - 如果应用要访问文件或目录，阅读 授权与文件概览，选择应用共享授权或用户个人授权。
- 如果应用需要打开宿主页面，阅读 页面路由。
- 如果应用页面需要跟随宿主语言或主题，阅读 页面交互；如果应用后端需要读取系统语言或系统版本，阅读 平台配置。
- 接口失败时，按 错误码 判断处理方式。