外部集成 API · 致远 OA 二开管理平台展示说明书架构日志
第 05 章

◷外部集成 API

功能

外部系统不经过浏览器登录,凭口令换令牌调数。

换令牌

POST /api/ext/token
{"username":"extapi","password":"<口令>","ttl_hours":12}
→ {"token":"...","expires_at":"..."}
  • 默认 12 小时,上限 168 小时;错 8 次 / 10 分钟 / IP 限流 429。
  • 改口令即吊销所有已签令牌(令牌无状态,靠口令轮换撤销)。

调接口

接口 说明
GET /api/ext/ping 免鉴权,探活
GET /api/ext/org?format=flat\|tree 87 部门,path_name 全路径
GET /api/ext/users?login_name=\|member_id=\|name=\|dept_id=\|limit\|offset 白名单字段,无口令/哈希

携带三选一:Authorization: Bearer <token> / X-Ext-Token / ?token=。

数据真相

  • 成员登录名以 ORG_PRINCIPAL.LOGIN_NAME 为准(ORG_MEMBER.CODE 大量为空)。
  • 用户资料无电话/邮箱字段(org_member 无 TEL/EMAIL 列)。
  • 每次调用写审计(EXT_TOKEN_OK/FAIL、EXT_ORG、EXT_USERS)。