身份与验证

IBAN 与银行信息校验 API

在转账失败之前就发现收款信息的错误。可任意组合发送 IBAN、BIC 和美国路由号码,获得具体问题、银行代码和账号、SEPA 成员资格,以及 BIC 是否与 IBAN 所属国家一致。

分类 身份与验证
API 端点 1
主要功能 4
常见问题解答 4

被这些公司的人员使用

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。

实时 服务状态

集成前,请先查看实时服务运行状况和文档中说明的失败响应。

OpenAPI API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥,并在调用前清楚显示积分成本。

10,000 免费额度

从每月 10,000 积分开始,只有在用量增长时再升级。

这个 API 可以帮你交付什么

把此页面当作生产集成简报:端点、示例、响应结构,以及把 DomScan 接入产品所需的工作流组件。

产品工作流

把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。

分析自动化

用计划任务、告警和可复现的调查步骤替代重复的人工查询。

干净的 JSON 数据

使用可预测字段、已记录的状态码和积分成本,而不是抓取供应商页面。

AI 和运维工具

通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。

集成流程

从第一次请求到可重复生产使用的简单路径。

1
一次认证

使用文档中的请求头发送 API 密钥,并在服务之间保持请求一致。

2
用示例查询

从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。

3
运行和监控

使用状态码、积分成本和响应字段构建重试、日志和告警。

开发者工具包

从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。

参数和响应映射

在把端点接入客户端前,快速查看输入、输出字段和状态码。

请求参数

参数

ibanbicrouting_number
响应字段

响应示例

validibaniban.validiban.ibaniban.iban_printiban.country_codeiban.bank_codeiban.account_numberiban.sepaiban.checksiban.checks.lengthiban.checks.structure
状态覆盖

HTTP 状态码

200400401402409422429

API 端点

POST /v1/bank/validate
积分: 1身份验证: 需要身份验证

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。

实时 服务状态

集成前,请先查看实时服务运行状况和文档中说明的失败响应。

OpenAPI API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥,并在调用前清楚显示积分成本。

10,000 免费额度

从每月 10,000 积分开始,只有在用量增长时再升级。

主要功能

支持所有 IBAN 国家

针对 IBAN 注册表中的每个国家检查国家代码、长度、本国账号格式和 ISO 7064 校验位,并涵盖使用母国格式的属地。

银行代码和账号

有效的 IBAN 会被拆分为银行代码、分行代码和账号,并同时提供电子格式和印刷格式。

BIC 和路由号码

检查 BIC/SWIFT 的结构和国家、测试代码,以及美国 ABA 路由号码的校验位和联邦储备区。

注重隐私的设计

校验离线运行。账号绝不会发送给第三方,也不会保留在请求日志中。

请求示例

POST /v1/bank/validate bash
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"

响应示例

200 OK json
{
  "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 有效能证明账户存在吗?

不能。它只证明 IBAN 格式正确,这能发现几乎所有输入错误。只有账户持有人的开户银行才能确认账户是否处于开通状态以及归谁所有。

BIC 来自其他国家时会怎样?

结果会带有一个提示信号,而不会报错,因为有些付款确实会使用其他国家的 BIC。根西岛、泽西岛或法国海外省等属地也能被识别。

会返回银行名称吗?

不会。目前没有免费、完整且官方的银行名称目录,因此 API 改为返回 IBAN 中的银行代码和分行代码。

每次调用消耗多少额度?

每次请求消耗一个额度,无论您发送的是 IBAN、BIC、路由号码还是三者全部。

相关工具和资源

HTTP 状态码

我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

成功 200

请求成功

请求错误 400

参数无效

未授权 401

API 密钥或会话缺失或无效。

需要付款 402

没有足够额度来执行此请求。

HTTP 409 409

我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

HTTP 422 422

我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

请求过多 429

超出速率限制