Dato

企业数据接口一把密钥接入

企业工商、身份要素核验、联行号、汇率，同一套鉴权和响应格式。按应用签发密钥，按调用扣点，重复查询不扣点。

申请开通阅读接入文档
  • 014 类数据 · 8 个接口
  • 02REST 与 MCP 共用一把密钥
  • 03出错不扣点

请求

$ curl -H "Authorization: Bearer $DATO_KEY" \  "https://dato.aidb.com.cn/api/v1/company/search?keyword=飞沐"

响应

200 OK

{  "data": {    "keyword": "飞沐", "page": 1, "total": 266,    "items": [{      "name": "北京飞沐网络科技有限公司",      "creditNo": "9111010808280962XP",      "regDate": "2013-11-25"    }]  },  "meta": {    "op": "company.search",    "fetchedAt": "2026-10-09T10:12:05+08:00",    "credits": 0,    "deduplicated": true,    "requestId": "9d2459aa3d9b7b18"  }}

重复查询：deduplicated 为 true，credits 为 0

  • GET/api/v1/company/search7 天内
  • GET/api/v1/company/query7 天内
  • POST/api/v1/idcard/verify实时
  • POST/api/v1/mobile/verify实时
  • POST/api/v1/bankcard/verify实时
  • GET/api/v1/bank/search30 天内
  • GET/api/v1/fx/rate1 小时内
  • GET/api/v1/fx/convert1 小时内

01可用数据

四类数据，一套调用方式

所有接口同一个地址前缀、同一种鉴权。成功返回 {data, meta}，出错返回 RFC 9457 问题详情，按 code 分支处理。

01company

企业工商

按名称关键词搜索企业，或按统一社会信用代码、全称、注册号取工商登记详情。

name
北京飞沐网络科技有限公司
creditNo
9111010808280962XP
regDate
2013-11-25
company.searchcompany.query常用于 · 供应商准入、合同主体核对、客户建档

02verify

身份要素核验

核验姓名与身份证号、手机号、银行卡是否属于同一人，只返回一致、不一致或查无记录。

"match"一致
"mismatch"不一致
"not_found"查无记录
idcard.verifymobile.verifybankcard.verify常用于 · 开户、签约、提现前确认身份

03bank

联行号

按支行名称或联行号查询银行网点，返回 12 位联行号、网点全称、地址与电话。

12 位联行号

bank.search常用于 · 付款填单、核对收款账户开户行

04fx

汇率

中国银行人民币牌价，23 个币种，含中间价与现汇、现钞买卖价；金额以字符串返回，不丢精度。

USD → CNY · 中间价

6.7367

23

个币种

中国银行人民币牌价

fx.ratefx.convert常用于 · 外币合同金额折算、报价换算
查看全部接口

02接入方式

业务系统和 AI 助手，用同一把密钥

调用方

业务系统REST
AI 助手MCP
类型化客户端OpenAPI

Dato

一把密钥 · 同一套鉴权

数据

企业工商company
身份要素核验verify
联行号bank
汇率fx

REST

/api/v1/{group}/{op}

按 /api/v1/{分组}/{接口} 调用，GET 与 POST 都可，Bearer 密钥鉴权。不提供 SDK，项目里已有的 HTTP 客户端即可接入；文档附 Java（OkHttp，Java 8 起）示例。

MCP

POST /mcp

POST /mcp，Streamable HTTP。工具与 REST 接口一一对应，可接入 Claude、FIM One 等 AI 助手，参数、返回与扣点规则相同。

OpenAPI

/api/openapi.json

/api/openapi.json 由接口登记实时生成，可用来生成类型化客户端；接口参考页可直接试调。另有 /llms.txt 供 AI 编程工具读取。

MCP 客户端配置

{ type: "http", url: "…/mcp" }

MCP/API 接入文档
mcp.jsonStreamable HTTP
{
  "mcpServers": {
    "dato": {
      "type": "http",
      "url": "https://dato.aidb.com.cn/mcp",
      "headers": { "Authorization": "Bearer <API Key>" }
    }
  }
}

03计费

按调用扣点，重复查询不扣

额度单位是「点」，发给租户，同一租户下所有应用共用一份余额。每次调用按接口单价扣一次，响应的 meta.credits 写明本次扣了多少。

重复查询本来就不扣点，调用方不必为了省点数自建缓存。

计费规则详情
#情况扣点
01

正常返回结果

按接口单价

按单价
02

同一租户、相同参数，拿到已经返回过的同一份数据

meta.deduplicated 为 true

0
03

参数错误、接口未启用、超出每日上限

请求在查询前被拒

0
04

数据源报错或超时

预扣的点当即退回

0
05

加 force=1 强制向数据源重新查询

按接口单价

按单价

04个人信息

核验类接口只返回结论

  1. 不回传要素，日志脱敏

    响应里不回传提交的姓名、证件号、手机号和卡号；调用日志里这些参数一律记为 [redacted]。

  2. 参数不进 URL

    核验类只接受 POST，要素放在 JSON 正文里，不出现在地址和访问日志中。

  3. 单独开通

    个人信息类接口须由管理员为应用单独开通，应用默认不包含。

  4. 摘要后再查询

    手机号三要素核验时，三项要素先做 SHA-256 摘要再发给数据源，不传明文。

请求正文POST dato.aidb.com.cn/api/v1/idcard/verify
{ "name": "张三", "idNo": "110105194912310021" }
响应200 OK
{ "data": { "result": "match" } }
调用日志idcard.verify
1c121f2c268d401b 200 match name=[redacted]idNo=[redacted]

调用前须取得被核验人的授权。

安全与合规说明

05管理

租户、应用、密钥三层

一个客户一个租户，额度和账单按租户出。租户下按调用方系统的环境建应用，密钥、启用的接口、每日上限和用量统计都按应用。

  1. 01

    租户

    • 额度批次
    • 月度账单
    • 成员
  2. 02

    应用

    • 启用的接口
    • 每日调用上限
    • 用量统计
  3. 03

    密钥

    • dato_3f9a1c2e_…
    • 有效期
    • 轮换与撤销

密钥明文只显示一次

签发时可设有效期。轮换时先发新密钥、各服务切换后再撤销旧的，中间不停机。

每日调用上限

防止调用方程序异常刷量。到上限后当天返回 429，次日零点（北京时间）恢复。

一键停用

怀疑泄露时停用应用，名下密钥立即失效；恢复后原密钥继续可用。

用量与账单

按租户、应用、接口统计调用与扣点，概览看 7 / 30 / 90 天趋势，账单按月导出 CSV。

余额提醒

余额低于提醒线、额度用尽、额度批次 7 天内到期时发邮件提醒。

可追溯

每个响应带 X-Request-Id；可选传 X-Dato-Actor 记录业务侧的操作人。

开通账号，拿到第一把密钥

账号由飞沐开通。留下公司与用途，我们联系你开通租户、发放额度。

申请开通阅读接入文档
  • 01REST 与 MCP
  • 02重复查询不扣点
  • 03出错退回预扣