很多单位的档案管理系统已经用了好几年，数据管得井井有条，可一到保管期限判定、年度判定、公文元数据录入、归档文件排列这些需要”专业判断”的环节，还是得档案员逐份翻规定、查表、手工录入。这不是软件不好用，而是它缺一个”会判断的大脑”–元泰档案知识库（启典）开放API：让现有档案软件外接智能判定。
启典知识库把这套档案专业能力，封装成了标准的开放 API。你的软件不用换、不用重做，只需”调一下接口”，就能直接获得 AI 级的档案业务能力。
一、为什么档案软件需要”外接大脑”？
市面上的档案管理软件、OA 系统，普遍擅长存储、流转、权限——它们是优秀的”档案柜”。但面对下面这类问题，它们往往力不从心：
- “这份文件该存永久还是30年？” ——需要对照8号令和本单位保管期限表
- “这份公文归哪一年？” ——跨年度会议、跨年办理的规则各不相同
- “这份红头文件的题名、文号、日期是什么？” ——需要从双层PDF里把文字层”摘”出来
- “几十份文件怎么按 DA/T 22 排顺序、编件号？” ——有成套性、有时间结合事由的排列规则
这些恰恰是启典知识库擅长的。我们把这些能力做成了 API 服务，任何软件都能”借”去用。
💡 一个比喻
你的档案软件是发动机，启典 API 是涡轮增压器。发动机不用拆、不用换，装上涡轮，动力立刻不一样。软件与软件之间，靠标准 HTTP 接口对话，数据在系统之间自动流动，人只需要在关键节点复核。
二、启典 API 是什么？
启典 API 是一套标准的 RESTful 接口服务，基于 FastAPI 构建，具备以下特点：
- 标准协议：HTTP + JSON，任何编程语言、任何操作系统都能调用
- 自带文档：服务启动后，访问
/docs即可看到完整的在线接口文档（Swagger UI），参数、示例一应俱全 - 安全鉴权：通过
X-Api-Key请求头验证身份，可在配置中关闭或自定义密钥 - 本地可跑：API 与知识库本体一同部署在档案室电脑或单位内网服务器，敏感数据不出办公室
- 异步并发：FastAPI 原生支持高并发，批量处理大文件时建议分批（每批 ≤ 500 条）
三、它提供哪些”智能能力”？
目前启典 API 开放了以下核心能力，覆盖档案整理全流程的判断环节：
| 能力 | 接口 | 说明 |
|---|---|---|
| 健康检查 | GET /health | 查询服务状态、运行模式（云端/本地）、当前模型 |
| 档案知识问答 | POST /ask | 档案业务问题直接问，答案带回法规依据原文 |
| 保管期限判定（单条） | POST /retention | 输入题名，返回永久/30年/10年及判定依据 |
| 保管期限判定（批量） | POST /retention/batch | 上传Excel，自动补全”保管期限”列，返回新Excel |
| 年度判定（单条） | POST /year | 输入题名+日期，返回所属年度及判定方法 |
| 年度判定（批量） | POST /year/batch | 上传Excel，自动补全”所属年度”列 |
| 公文元数据提取 | POST /extract | 上传双层PDF，自动提取题名/责任者/日期/文号 |
| 归档文件排列二期新增 | POST /arrange | 上传归档目录Excel，按 DA/T 22 自动排列并生成件号、标准档号 |
| 排列预览二期新增 | POST /arrange/preview | 返回 JSON 预览，供软件先展示排列结果再确认 |
其中规则命中的准确率在 95% 以上；规则库未覆盖的特殊情形，会由 AI 模型综合判断兜底，并返回”判定方法”字段，方便软件提示人工复核。
四、怎么和你的软件打通？
启典 API 不挑平台、不挑语言。根据你们现有的系统情况，有三种常见的对接方式：
🔸 方式一：元泰数字档案室软件（魔方）——原生联动
如果你们用的是元泰魔方数字档案室软件，对接最为直接。启典在电子档案入库流程中自动完成：
1自动判定保管期限 —— 文件进入系统，启典根据题名匹配规则，永久/30年/10年直接填好
2自动判定归档年度 —— 根据成文日期自动确定归属年份
3自动排列+编件号 —— 调用 /arrange，按 DA/T 22 排出顺序、生成标准档号（如 G123-WS-2026-Y-0001）
4写回魔方字段 —— 判定与排列结果直接回写电子档案记录，无需二次录入
🔸 方式二：其他品牌档案软件——流程改造
不用魔方也能用。启典本质上是一套标准 API 服务，只要你的档案软件能发 HTTP 请求（几乎所有现代软件都可以），就能对接。改造的核心思路很简单：在电子档案入库流程中，增加一步”调用启典 API 判定”的操作。
我们已用 Python、Java、VBA（Excel 宏）、PHP 等多种语言验证过对接，改造量通常不大，具体方案可联系我们评估。
🔸 方式三：OA / 政务云——云端 SaaS 调用
对于已经在云上、或计划接入政务云的单位，启典也可在互联网侧提供 API 服务。你的 OA 或档案系统配置 API 地址与密钥，整理过程中自动联网调用，按调用量计费。敏感信息可先本地脱敏再调用，或选择完全本地部署模式。
五、一段代码，看懂怎么调用
以”批量判定保管期限”为例，Python 只需几行：
import requests BASE = “http://localhost:8000” HEADERS = {“X-Api-Key”: “你的密钥”} # 上传 Excel，自动补全”保管期限”列 with open(“公文目录.xlsx”, “rb”) as f: resp = requests.post( f”{BASE}/retention/batch”, files={“file”: (“公文目录.xlsx”, f)}, headers=HEADERS, ) with open(“判定结果.xlsx”, “wb”) as out: out.write(resp.content) # 直接得到带判定结果的 Excel
Java、VBA、PHP 的对接示例我们在《API 调用说明》中均有完整代码。接口返回标准 JSON，软件解析后写入自己的数据表即可。
六、数据不出办公室
对档案行业来说，数据安全是底线。启典 API 默认与知识库一同本地部署在单位内网：
- 数据不离场：公文题名、元数据、目录都在本机处理，不向外传输原始文件
- 双模式可选：联网环境可用云端大模型（混元）；涉密内网可切换为本地模型（Ollama + 国产大模型），完全脱机运行
- 密钥鉴权：接口调用需携带 API Key，可随时更换或关闭
- 最小暴露：知识库文档和上传文件不通过 API 暴露原始路径
七、总结
启典 API 的价值，不在于”又做了一个软件”，而在于让你们已有的软件，更低成本地获得档案专业能力。它不改你的系统架构，不碰你的存量数据，只是在关键的判断环节，把专业知识和 AI 判断”喂”给你的软件。
对软件厂商，它是可集成的智能模块；对档案室，它是嵌入工作流的自动助手；对开发商，它是少写几千行业务规则的技术红利。
想让现有系统”聪明”起来？
第一步：访问 ytshuju.cn 知识库页面，直接体验演示版功能
第二步：查看《API 调用说明》，评估对接方案
第三步：联系我们，获取本地部署包与对接技术支持
📋 更多实用干货 → 关注公众号「元泰数据」 | 🔧 技术方案 → ytshuju.cn
*本文提到的启典知识库由呼和浩特市元泰电子科技有限责任公司提供技术支持。实际对接效果以现场评估为准。
*文中接口清单基于启典知识库 v2.0（含二期档案排列功能）。获取最新《API 调用说明》请联系元泰公司。