91APP - API - 开放接口与开发者接入指南

91APP 的 API 频道提供哪些接口分类？

91APP 的 API 频道提供四类接口：身份鉴权、数据读取、任务调度与事件回调，覆盖从登录到数据回传的完整链路。所有接口统一挂在 api.91ncomh.cloud 域名下，按业务域划分子路径，便于开发者按需取用。

身份鉴权类负责 Token 签发与刷新，是调用其他接口的前置条件；数据读取类提供内容列表、详情、统计三类查询；任务调度类用于触发批量同步、导出与异步作业；事件回调类则把系统侧的状态变化主动推送到开发者服务器。四类接口共用同一套错误码体系，定位问题时可跨模块对照。

对于刚接触 91N 工具生态的团队，建议先跑通鉴权与一个只读接口，再逐步接入写操作。这样能把调试成本控制在较低水平，也方便在 91N 社区里对照示例排查。

核心接口模块速览

以下 10 个模块是 91APP API 中使用频率最高的部分，覆盖鉴权、查询、同步与回调等常见开发场景。每个模块都配有独立文档页，包含请求参数、返回示例与错误码说明。

如何完成一次标准的 API 接入？

一次标准接入分四步：申请应用凭据、获取 Token、调用业务接口、处理回调与错误。按这个顺序推进，通常可在半天内跑通主链路，这也是 91APP 文档推荐的上手路径。

1. 申请凭据：在控制台创建应用，拿到 AppKey 与 AppSecret，二者不要写进前端代码。
2. 换取 Token：调用鉴权接口获取 Bearer Token，缓存并在到期前刷新。
3. 调用接口：按业务域拼接路径，携带 Token 发起请求，注意分页与字段裁剪。
4. 处理回调：校验签名后再落库，并对失败事件做幂等重试。

调试阶段建议使用沙箱环境，正式上线前再切换到生产域名。91N 教程中记录的常见坑集中在时间戳偏移与签名拼接顺序，接入时可以先对照示例逐字段核对。

接口调用失败时，先看 HTTP 状态码，再看返回体里的 code 字段，最后才查业务日志。绝大多数问题在前两步就能定位。

开发者常见问题（FAQ）

关于 91APP API 开放接口的说明

截至 2025 年 6 月，91APP 的 API 开放接口已覆盖鉴权、数据、任务与回调四大类能力，文档版本同步至 v3.2。接口设计遵循统一返回结构与统一错误码，降低跨模块的适配成本。

对开发者而言，91N 官网与 91N 社区是获取 91N 更新与 91N 教程的主要入口，91N 传媒相关内容的分发场景也常通过 API 完成对接。若你同时使用 91N 工具与效率软件，建议把鉴权模块单独封装成中间层，后续新增接口时只需扩展业务方法。

需要提醒的是，接口凭据属于敏感信息，请放在服务端环境变量中，不要提交到代码仓库。软件下载与调试工具请从可信渠道获取，接入过程中遇到异常，先核对时间戳与签名，再联系技术支持。