集成前,请先查看实时服务运行状况和文档中说明的失败响应。
被出色公司的人们使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 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/agent-readiness
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
主要功能
在一个响应中评估可发现性、内容、访问策略和能力。
通过得满分,警告得部分分,失败不得分。未知检查不计入评分并降低置信度。
查看每项检查的状态、权重、方法、证据、注意事项、参考信息和成熟度标签。
在发布检查、监控、组合审查和内部质量流程中使用一致的评分和建议,而不执行发现的工具。
请求示例
curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/agent-readiness
响应示例
{
"outcome": "complete",
"summary": {
"coverage": "multi_channel",
"detected_signals": 2,
"total_signals": 4
},
"signals": {
"webmcp": { "status": "unknown", "validation": "runtime_required" },
"remote_mcp": { "status": "not_detected" },
"openapi": { "status": "detected", "validation": "confirmed" },
"llms_txt": { "status": "detected", "validation": "confirmed" }
},
"recommendations": [
{ "code": "ADD_WEBMCP_TOOLS", "severity": "low" }
]
}
常见问题解答
当有明确的检查结果时,返回 0-100 评分、四项维度评分、35 多项有界检查、置信度、证据、注意事项、成熟度标签和建议。
未知表示无法根据可用证据得出检查结论。它不计入评分并降低置信度,不要将其视为通过或失败。
不会。就绪度检查评估发现信号,不会调用发现的 WebMCP 或应用工具。
根据重要性为有明确结论且适用的检查加权。通过得满分,警告得一半分,失败不得分。未知检查被排除并降低置信度。评分不是 SEO 排名,也不保证兼容性。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
API 密钥或会话缺失或无效。
没有足够额度来执行此请求。
超出速率限制
上游 RDAP 错误

