集成前,请先查看实时服务运行状况和文档中说明的失败响应。
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报:端点、示例、响应结构,以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本,而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
使用文档中的请求头发送 API 密钥,并在服务之间保持请求一致。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前,快速查看输入、输出字段和状态码。
参数
响应示例
HTTP 状态码
API 端点
/v1/bank/validate
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
集成前,请先查看实时服务运行状况和文档中说明的失败响应。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
主要功能
针对 IBAN 注册表中的每个国家检查国家代码、长度、本国账号格式和 ISO 7064 校验位,并涵盖使用母国格式的属地。
有效的 IBAN 会被拆分为银行代码、分行代码和账号,并同时提供电子格式和印刷格式。
检查 BIC/SWIFT 的结构和国家、测试代码,以及美国 ABA 路由号码的校验位和联邦储备区。
校验离线运行。账号绝不会发送给第三方,也不会保留在请求日志中。
请求示例
curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
-d '{"iban": "DE89 3704 0044 0532 0130 00", "bic": "COBADEFFXXX"}' \
"https://domscan.net/v1/bank/validate"
响应示例
{
"valid": true,
"iban": {
"valid": true,
"iban": "DE89370400440532013000",
"iban_print": "DE89 3704 0044 0532 0130 00",
"country_code": "DE",
"bank_code": "37040044",
"account_number": "0532013000",
"sepa": true,
"checks": { "length": "pass", "structure": "pass", "checksum": "pass" }
},
"bic": { "valid": true, "bic": "COBADEFFXXX", "institution_code": "COBA", "country_code": "DE" },
"bic_iban_country_relation": "same",
"signals": []
}
常见问题解答
不能。它只证明 IBAN 格式正确,这能发现几乎所有输入错误。只有账户持有人的开户银行才能确认账户是否处于开通状态以及归谁所有。
结果会带有一个提示信号,而不会报错,因为有些付款确实会使用其他国家的 BIC。根西岛、泽西岛或法国海外省等属地也能被识别。
不会。目前没有免费、完整且官方的银行名称目录,因此 API 改为返回 IBAN 中的银行代码和分行代码。
每次请求消耗一个额度,无论您发送的是 IBAN、BIC、路由号码还是三者全部。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
API 密钥或会话缺失或无效。
没有足够额度来执行此请求。
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
超出速率限制

