计费

按调用扣点

额度单位是「点」,按批发放给租户。每次调用按接口单价扣一次,重复查询和出错不扣。

meta200 OK
"meta": {
  "op": "company.search",
  "credits": 0,
  "deduplicated": true,
  "requestId": "9d2459aa3d9b7b18"
}

01

接口单价

每个接口有各自的单价,随开通方案约定,由平台调整、对新调用生效。开通后在工作台「接口」页查看,或调 GET /api/v1/ops 读取 credits 字段;每次调用实际扣了多少,看响应的 meta.credits。

GET /api/v1/ops → creditsmeta.credits

02

什么时候扣点

01

正常返回结果

按接口单价

扣点
02

重复查询:同一租户、相同参数、拿到已经返回过的同一份数据

响应 meta.deduplicated 为 true

不扣
03

强制回源(force=1)

按接口单价

扣点
04

查无记录(企业不存在、核验 not_found、联行号无结果)

查询已完成;重复查询同样不扣

扣点
05

身份要素核验

每次实时核验,没有重复查询

扣点
06

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

请求在查询前被拒

不扣
07

数据源报错或超时

已预扣的点当即退回

不扣

03

额度批次

发放
按批发放到租户,每批写明点数、有效期(默认 365 天)与来源(购买、赠送、试用、调整)
到期
每批到期作废,不按月清零,也不顺延
扣减顺序
从最早到期、且余额够本次单价的那一批里扣,一次调用不会拆到两批
余额
所有未到期批次的余额合计,可在工作台查看或调 GET /api/v1/quota
额度不足
返回 402 quota_exceeded,带本次所需 need 与当前可用 available;补额度后原样重发即可

04

账单

账单按自然月(北京时间)汇总,每行一个「应用 × 接口」,列出调用次数、重复查询(不扣点)次数、错误次数与实际扣点,可导出 CSV 用 Excel 直接打开。

常见问题

怎么获得额度?

额度由飞沐按批发放到租户,暂不支持自助购买。每批写明点数与有效期,来源包括购买、赠送与试用。通过本站「申请开通」联系我们。

额度会按月清零吗?

不会。每批到期作废,不按月清零,也不顺延;扣点从最早到期、且余额够本次单价的那一批里扣。

需要自己做缓存来省点数吗?

不需要。同一租户以相同参数再次查询、拿到已经返回过的同一份数据时不扣点。只有要求更低延迟、或数据源故障时也要有数可用的场景,才值得在本地另存一份。

查无记录扣点吗?

扣。企业不存在、核验结论为 not_found、联行号无结果,都是查询已完成的结论;重复查询同样不扣。

多个系统可以共用一份额度吗?

可以。额度发给租户,同一租户下的所有应用共用一份余额;用量与账单按应用分开统计。

有 SDK 吗?

不提供 SDK。接口是普通 HTTP + JSON,用项目里已有的 HTTP 客户端即可;需要类型化客户端可用 OpenAPI 规范生成。

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

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