第 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)。