集成前,请先查看实时服务运行状况和文档中说明的失败响应。
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 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/accessibility
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
主要功能
检查涵盖 WCAG A 和 AA 成功标准以及最佳实践,从缺少替代文本和标签,到颜色对比度和 ARIA 误用。
违规项按从严重到轻微排序,并附有受影响元素的数量、示例选择器和 HTML。
需要人工判断的规则会单独列出,因此自动检查通过绝不会被误认为完全合规。
页面在 JavaScript 运行后才进行审计,因此动态菜单、表单和内容也在检查范围内。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/accessibility?url=example.com"
响应示例
{
"status": "ok",
"score": 84,
"summary": { "violations": 4, "affected_elements": 23, "by_impact": { "critical": 1, "serious": 2, "moderate": 1, "minor": 0 } },
"violations": [
{
"id": "image-alt",
"impact": "critical",
"wcag_level": "A",
"help": "Images must have alternate text",
"node_count": 6,
"nodes": [{ "target": "main > img.hero", "html": "<img src="/hero.jpg">" }]
}
]
}
常见问题解答
不是。自动化工具只能发现一部分无障碍障碍。请用结果修复明显的问题,然后再进行人工测试以及辅助技术测试。
将通过的规则与按影响程度加权的违规项进行比较:严重 3,较严重 2,中等 1,轻微 0.5。
WCAG 2.0、2.1 和 2.2 的 A 和 AA 等级,以及常见最佳实践,并在每个违规项上标注。
每次审计 8 积分。被拦截或失败的页面会退还积分。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
API 密钥或会话缺失或无效。
没有足够额度来执行此请求。
超出速率限制

