集成前,请先查看实时服务运行状况和文档中说明的失败响应。
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 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/name-check
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
主要功能
域名、平台账号名和软件包名并行检查,并在一次响应中返回。
返回 available_everywhere、mostly_available、contested 或 unknown,以及在已确定结果中可用项所占的比例。
可选择最多 20 个后缀、任意受支持的平台或全部平台,以及与您的技术栈相关的注册表。
被阻止、被限流或失败的检查会报告为未知,并且不计入评分。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/name-check?name=acmeflow&tlds=com,io,ai"
响应示例
{
"name": "acmeflow",
"verdict": "mostly_available",
"score": 80,
"summary": {
"com_available": false,
"domains": { "checked": 3, "free": 2, "taken": 1, "unknown": 0 },
"handles": { "checked": 20, "free": 17, "taken": 2, "unknown": 1 },
"packages": { "checked": 7, "free": 6, "taken": 1, "unknown": 0 }
},
"domains": [{ "domain": "acmeflow.io", "status": "available" }],
"handles": [{ "platform": "github", "status": "available" }],
"packages": [{ "registry": "npm", "status": "not_found" }]
}
常见问题解答
每个名称 5 积分,与所选列表无关。如果完全无法得出任何结果,积分将退还。
没有软件包使用该名称。不过 npm 和 PyPI 等注册表仍可能拒绝与现有名称过于相似的名称,因此 not_found 是一个强有力的信号,而不是保证。
支持字母、数字和中间的连字符,长度为 2 到 63 个字符,因此同一个名称可同时用作域名、账号名和软件包名。
可以。它以 name_check MCP 工具的形式提供,因此助手可以提出候选名称,并只保留可用的名称。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
API 密钥或会话缺失或无效。
没有足够额度来执行此请求。
超出速率限制

