计费
按调用扣点
额度单位是「点」,按批发放给租户。每次调用按接口单价扣一次,重复查询和出错不扣。
"meta": {
"op": "company.search",
"credits": 0,
"deduplicated": true,
"requestId": "9d2459aa3d9b7b18"
}01
接口单价
每个接口有各自的单价,随开通方案约定,由平台调整、对新调用生效。开通后在工作台「接口」页查看,或调 GET /api/v1/ops 读取 credits 字段;每次调用实际扣了多少,看响应的 meta.credits。
GET /api/v1/ops → creditsmeta.credits02
什么时候扣点
正常返回结果
按接口单价
重复查询:同一租户、相同参数、拿到已经返回过的同一份数据
响应 meta.deduplicated 为 true
强制回源(force=1)
按接口单价
查无记录(企业不存在、核验 not_found、联行号无结果)
查询已完成;重复查询同样不扣
身份要素核验
每次实时核验,没有重复查询
参数错误、未启用的接口、超出每日上限
请求在查询前被拒
数据源报错或超时
已预扣的点当即退回
03
额度批次
- 发放
- 按批发放到租户,每批写明点数、有效期(默认 365 天)与来源(购买、赠送、试用、调整)
- 到期
- 每批到期作废,不按月清零,也不顺延
- 扣减顺序
- 从最早到期、且余额够本次单价的那一批里扣,一次调用不会拆到两批
- 余额
- 所有未到期批次的余额合计,可在工作台查看或调 GET /api/v1/quota
- 额度不足
- 返回 402 quota_exceeded,带本次所需 need 与当前可用 available;补额度后原样重发即可
04
账单
账单按自然月(北京时间)汇总,每行一个「应用 × 接口」,列出调用次数、重复查询(不扣点)次数、错误次数与实际扣点,可导出 CSV 用 Excel 直接打开。
常见问题
怎么获得额度?
额度由飞沐按批发放到租户,暂不支持自助购买。每批写明点数与有效期,来源包括购买、赠送与试用。通过本站「申请开通」联系我们。
额度会按月清零吗?
不会。每批到期作废,不按月清零,也不顺延;扣点从最早到期、且余额够本次单价的那一批里扣。
需要自己做缓存来省点数吗?
不需要。同一租户以相同参数再次查询、拿到已经返回过的同一份数据时不扣点。只有要求更低延迟、或数据源故障时也要有数可用的场景,才值得在本地另存一份。
查无记录扣点吗?
扣。企业不存在、核验结论为 not_found、联行号无结果,都是查询已完成的结论;重复查询同样不扣。
多个系统可以共用一份额度吗?
可以。额度发给租户,同一租户下的所有应用共用一份余额;用量与账单按应用分开统计。
有 SDK 吗?
不提供 SDK。接口是普通 HTTP + JSON,用项目里已有的 HTTP 客户端即可;需要类型化客户端可用 OpenAPI 规范生成。