实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
分类
安全与信任
API 端点
1
主要功能
4
常见问题解答
4
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
10,000
免费额度
从每月 10,000 积分开始，只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
一次认证
使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。
用示例查询
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
运行和监控
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
domain
响应示例
unicodeasciiis_idnvalidskeletonriskrisk.levelrisk.reasons
HTTP 状态码
200400401402429
API 端点
GET
/v1/idn
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
服务状态
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
免费额度
免费注册
从每月 10,000 积分开始，只有在用量增长时再升级。
活跃
请求示例
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
主要功能
UTS 46 转换
双向转换 Unicode 与 Punycode，并检查标签与名称的长度限制。
文字与字符检查
列出每个标签中的文字，标出允许的 CJK 组合之外的混合文字标签，并检测不可见字符。
易混淆字符骨架
将外观相似的西里尔、希腊、亚美尼亚和全角字符映射为拉丁字母的样子，方便您将名称与其所冒充的品牌进行比较。
无需网络调用
分析完全在 DomScan 上运行，因此结果即时返回，相同输入的结果始终一致。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/idn?domain=xn--80ak6aa92e.com"响应示例
{
"unicode": "аррӏе.com",
"ascii": "xn--80ak6aa92e.com",
"is_idn": true,
"valid": true,
"skeleton": "apple.com",
"risk": { "level": "high", "reasons": ["idn_label", "whole_script_confusable"] }
}常见问题解答
什么时候风险为高？
当标签将拉丁字母与西里尔、希腊或亚美尼亚字母混用、非拉丁标签读起来完全像拉丁字母，或包含不可见字符时。
使用了完整的 Unicode 易混淆字符列表吗？
没有。使用的是精选的最常见相似字符子集，每个响应都会说明这一点，因此低风险的结果并不能证明安全。
可以发送 Punycode 吗？
可以。发送任一形式，都会返回两种形式，以及每个标签是否为 IDN。
需要多少积分？
每次请求 1 积分。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
请求错误
400
参数无效
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制