易仓数据账户配置指南
1. 接入前准备
准备一个已开通易仓 API 权限的企业账号。连接器需要同一应用的应用 Key、签名密钥和服务 ID;只需在数据账户页面填写这三项,不需要自行编写签名代码。
易仓后台入口:工作台-应用管理。如果账号无法查看应用或授权信息,请先联系企业管理员。
2. 在易仓准备应用
2.1 打开或创建对接应用
登录企业所属的易仓开放平台,进入“应用管理”。优先使用本次对接的现有应用;没有合适应用时再创建。企业自研场景按后台说明选择应用类型,填写名称与说明,并申请实际需要读取的业务接口。

2.2 配置 IP 白名单
在应用的 IP 白名单中同时添加以下两个公网出口,保存配置。两个地址都应保留,避免切换执行节点后出现访问失败:
119.13.94.136 124.70.196.23

2.3 确认审核与授权状态
提交创建或变更后,确认应用审核已通过、处于启用状态,并且所需业务接口已获得授权。仅取得 Key 或填写白名单,并不代表应用已可调用;如果仍显示待审核或变更待审核,应先完成易仓侧审核流程。
2.4 取得三项凭据
| 易仓信息 | 获取位置 | 核对事项 |
| APP Key | 目标应用的应用列表或详情 | 确认是本次授权应用 |
| Secret Key | 同一应用的密钥信息 | 与 APP Key 配套,不要公开或截图外传 |
| 服务 ID | 同一应用的授权状态,点击“查看”后选择目标环境及已授权服务 | 复制服务 ID,不是应用名称或服务名称 |


上方易仓后台图片沿用现有社区指南的真实示例,并做进一步遮盖;不是本次登录后台的新截图。请以当前后台的字段名称和提示为准。
3. 在连接器新增数据账户
进入“数据账户管理”,点击新增,所属平台选择“易仓”。账户名称用于识别这套凭据,可填写企业或业务用途。

| 连接器字段 | 字段编码 | 填写内容 | 必填 |
| 应用 Key | app_key | 易仓 APP Key | 是 |
| 签名密钥 | secret_key | 同一应用的 Secret Key | 是 |
| 服务 ID | service_id | 同一应用、对应环境的授权服务 ID | 是 |
测试与保存
- 核对三个字段来自同一应用与环境,去掉复制时带入的空格和换行。
- 确认两个 IP 都已加入白名单,应用审核和接口授权均已完成。
- 点击“测试连接”;成功后点击“确定”保存。
- 再配置需要读取的业务接口。测试连接通过不代表所有接口权限都已开通。
4. 常见问题
| 提示或现象 | 处理方法 |
应用未审核通过
saas.api.error.code.0021 | 进入易仓应用管理查看审核状态,完成审核后重试。该提示不能仅靠更换 IP 或切换连接器节点解决。 |
| 来源 IP 不在白名单 | 核对应用白名单是否同时包含 119.13.94.136 和 124.70.196.23,确认已保存;如变更需要审核,先完成审核。 |
| 签名或凭据校验失败 | 重新核对 APP Key、Secret Key 与服务 ID 是否配套,有无多余空格;重置过密钥时使用最新密钥。 |
| 没有接口或服务权限 | 在目标环境的授权信息中核对具体接口权限,不能只看应用启用状态。 |
| 测试通过,某类业务数据仍失败或为空 | 检查该业务接口是否授权、账户的数据访问范围,以及查询时间条件。 |
|