接口
数据接口
4 类 8 个接口，同一套鉴权、响应与错误格式。单价随开通方案约定，开通后在工作台「接口」页查看。
机器可读清单含参数，无需密钥
GET https://dato.aidb.com.cn/api/v1/ops?all=101company
企业工商
按名称关键词搜索企业，或按统一社会信用代码、全称、注册号取工商登记详情。
来源企业登记公示信息
| 接口 | 方法 | 数据时效 | 必填参数 |
|---|---|---|---|
企业模糊搜索 company.search按名称关键词、注册号或信用代码搜索，每页 20 条 | GET / POST/api/v1/company/search | 7 天内 | keyword |
企业工商详情 company.query按信用代码、全称或注册号取工商登记详情 | GET / POST/api/v1/company/query | 7 天内 | creditNo | name | regNo |
02verify
身份要素核验
核验姓名与身份证号、手机号、银行卡是否属于同一人，只返回一致、不一致或查无记录。
来源核验通道，经合作数据服务商接入
| 接口 | 方法 | 数据时效 | 必填参数 |
|---|---|---|---|
身份证二要素需单独开通 idcard.verify姓名与身份证号是否一致 | POST/api/v1/idcard/verify | 实时 | nameidNo |
手机号三要素需单独开通 mobile.verify手机号、姓名、身份证号是否属于同一人，附运营商 | POST/api/v1/mobile/verify | 实时 | mobilenameidNo |
银行卡三 / 四要素需单独开通 bankcard.verify卡号、姓名、身份证号，传手机号即按四要素核验 | POST/api/v1/bankcard/verify | 实时 | cardNonameidNo |
03bank
联行号
按支行名称或联行号查询银行网点，返回 12 位联行号、网点全称、地址与电话。
来源人民银行支付系统行号信息
| 接口 | 方法 | 数据时效 | 必填参数 |
|---|---|---|---|
联行号查询 bank.search按支行名或联行号查询，可按银行、省、市筛选 | GET / POST/api/v1/bank/search | 30 天内 | keyword |
04fx
汇率
中国银行人民币牌价，23 个币种，含中间价与现汇、现钞买卖价；金额以字符串返回，不丢精度。
来源中国银行人民币牌价
| 接口 | 方法 | 数据时效 | 必填参数 |
|---|---|---|---|
汇率查询 fx.rate两种货币间的中间价或买卖价 | GET / POST/api/v1/fx/rate | 1 小时内 | fromto |
汇率换算 fx.convert按指定汇率类型换算金额 | GET / POST/api/v1/fx/convert | 1 小时内 | fromtoamount |
共用约定
所有接口共用的约定
- 地址
- /api/v1/{分组}/{接口}，如 /api/v1/fx/rate
- 鉴权
- 请求头 Authorization: Bearer <API Key>，也接受 X-Api-Key
- 请求
- GET 时参数走查询串，POST 时放 JSON 正文；核验类只接受 POST
- 成功响应
- {data, meta}；meta 含数据取得时间 fetchedAt、扣点 credits、是否重复查询 deduplicated、requestId
- 错误响应
- RFC 9457 问题详情（application/problem+json），按 code 写分支，不按 HTTP 状态码
- 数据时效
- 每个接口固定时效，meta.fetchedAt 为确切时间；force=1 强制回源，照常扣点
- 版本兼容
- v1 内只加字段、不删改；不兼容的改动只以 /api/v2/ 出现，并预告迁移期
接口参考与试调
接口参考页由 OpenAPI 实时渲染，参数、返回字段与错误码与线上同源，登录后可在页面上直接试调。