## 接口说明
用友 U8 开放平台(U8OpenAPI)的所有业务接口调用前,必须先获取全局识别码 token。token 生命周期为 2 小时,可重复使用,多个业务接口共用同一个 token;平台限制两小时内最多获取 2000 次,因此调用方必须在本地缓存 token,快过期时再刷新。
### 请求参数
1. from_account:来源方账号(应用提供方分配的账套标识)。
2. to_account:目标方账号(U8 企业账套标识)。
3. app_key / app_secret:在 U8 开放平台应用中心创建应用后获得。
4. token:获取新 token 时可带旧 token 续期,首次获取置空。
### 响应说明
返回 errcode 为 0 表示成功,token 对象包含 id(token 值)、appKey 与 expiresIn(秒)。调用业务接口时,把 token 与 from_account、to_account、app_key、app_secret 一起作为 URL query 参数传递。
### 生产建议
- 轻易云 U8 连接器集中托管 token 生命周期:单例缓存 + 过期前 5 分钟主动刷新 + 失败熔断重取,避免多任务并发刷 token 触发 2000 次/2h 限额。
- 私有化 U8 需要部署用友 OpenAPI 客户端代理,外网系统经代理转发到 U8 应用服务器。
### 适用边界
U8 OpenAPI 适合外网系统与 U8 的标准对接,但它不支持上下游关联生单,复杂业务(如采购入库单关联到货单)需要 EAI 或 CO 组件方式补充;同时 OpenAPI 按接口授权与流量收费,选型时应把 license 成本纳入整体评估,避免上线后产生预期外费用。