01 · GETTING STARTED
三步完成接入
所有数据服务均通过统一网关访问，调用前请确认应用密钥与授权范围。
01
申请应用密钥
由平台数据服务运营团队分配 App Key 与密钥，并绑定可访问的数据域与 QPS 配额。
02
携带鉴权请求头
在请求头中携带 X-App-Key，敏感级别为「机密」的接口还需申请 OAuth2 令牌。
03
调用与计量
网关自动记录调用日志、响应时延与配额用量，按应用维度生成计量账单与审计报表。
02 · SERVICE CATALOG
服务目录
当前共 26 个在线服务，以下展示最近发布的 12 个。
| 服务名称 | 方法 | 路径 | 数据模型 | 鉴权 | 敏感级别 | QPS | 状态 |
|---|---|---|---|---|---|---|---|
| 客户360视图查询服务API001 · v1.0 | GET | /v1/customer/360 |
客户主数据模型 | APIKey | 内部 | 200 | 已发布 |
| 客户主数据分页查询API002 · v1.1 | POST | /v1/customer/list |
客户主数据模型 | APIKey | 内部 | 50 | 已发布 |
| 供应商资质核验服务API003 · v1.2 | GET | /v1/supplier/qualification |
供应商主数据模型 | OAuth2 | 敏感 | 500 | 已发布 |
| 物料标准编码解析API004 · v1.0 | GET | /v1/material/code/resolve |
物料主数据模型 | APIKey | 公开 | 200 | 已发布 |
| 门店经营日报服务API005 · v1.1 | GET | /v1/store/daily-metrics |
门店主数据模型 | APIKey | 内部 | 100 | 已发布 |
| 经销商区域授权查询API006 · v1.2 | GET | /v1/dealer/territory |
经销商主数据模型 | JWT | 敏感 | 100 | 灰度 |
| 员工组织关系查询API007 · v1.0 | GET | /v1/employee/org |
员工主数据模型 | OAuth2 | 敏感 | 20 | 已发布 |
| 主数据变更订阅服务API008 · v1.1 | POST | /v1/master/change/subscribe |
客户主数据模型 | JWT | 内部 | 20 | 已发布 |
| 设备资产台账查询API009 · v1.2 | GET | /v1/asset/ledger |
设备资产主数据模型 | APIKey | 内部 | 50 | 已发布 |
| 银行账户校验服务API010 · v1.0 | POST | /v1/bank/account/verify |
银行账户主数据模型 | OAuth2 | 机密 | 100 | 已发布 |
| 项目预算执行查询API011 · v1.1 | GET | /v1/project/budget |
项目主数据模型 | APIKey | 敏感 | 100 | 已发布 |
| 客户标签批量查询API013 · v1.0 | POST | /v1/customer/tags |
客户主数据模型 | APIKey | 内部 | 200 | 已发布 |
03 · REQUEST EXAMPLE
调用示例
以客户 360 视图查询服务为例，返回统一主数据视图。
cURL
curl -X GET \
"https://api.rconrrj.autoambe.com/v1/customer/360?customer_code=CUST-20260018" \
-H "X-App-Key: $APP_KEY" \
-H "Content-Type: application/json"Response · 200
{
"code": 0,
"msg": "success",
"request_id": "RQ9F2K7Q1M4T8R",
"service": {
"code": "API001",
"name": "客户360视图查询服务",
"version": "v1.0"
},
"data": {
"total": 80,
"page": 1,
"size": 10,
"items": [
{
"code": "CUST-20260001",
"name": "佛山智能制造有限公司",
"quality_score": 98.6
}
]
},
"meta": { "latency_ms": 42 }
}生产环境请通过 HTTPS 调用，密钥禁止写入前端代码；平台对敏感字段默认脱敏返回，如需明文需单独申请并记录审计。
04 · ERROR CODES
错误码说明
401
缺少或无效的 App Key
请检查请求头 X-App-Key 是否正确，或联系平台运营开通授权。
403
无该数据域访问权限
当前应用未被授予对应主数据模型的访问范围。
404
接口不存在或未发布
服务可能处于草稿、灰度未授权或已下线状态。
429
超出 QPS 或日配额限制
请降低调用频率，或提交配额扩容申请。
500
网关内部异常
请携带 request_id 联系平台运维团队定位。