域名注册前置检测接口 · 接入文档

〇、这个接口是做什么的？（30 秒看懂）

用户在您机构注册域名时（例如想注册 baiidu.com），您的系统实时调用本平台接口，平台毫秒级比对 2500+ 认证品牌库，返回三级建议：clear（没问题，放行）/ flag（有风险，建议重点监控）/ hold（高度疑似仿冒，建议先别完成注册、人工核实）。
它是"建议"，不是"命令"——注册决定权始终在您机构；平台也承诺：接口出问题时应按放行处理（见第五节）。

一、接入前准备（一次性，约 10 分钟）

① 平台管理员在「🤝 合作方管理」添加您机构全称 → 系统签发一串 PK- 开头的 KEY（只显示一次，请妥善保存）；
② 把 KEY 交给贵司开发，配置到注册系统；
③ 先用测试域名（如 mytest-123.com）跑通（返回 clear 即通），再切正式流程。

二、怎么调用（HTTP 请求）

接口地址：https://cert.dimiao.cn/api.php?action=precheck
请求方式：GET 或 POST 均可，两个参数：

domain：要注册的域名（必填，不带 http、不带路径，如 baiidu.com；可自动剥离，但建议传干净域名）；
apikey：您的 KEY（必填）。
推荐做法：把 KEY 放在 HTTP 请求头里而不是网址里（避免出现在服务器访问日志）：X-API-Key: PK-xxxxxxxx。若您的系统不方便加请求头，用 &apikey=PK-xxx 也可以。

完整示例（可直接在浏览器地址栏测试）：
https://cert.dimiao.cn/api.php?action=precheck&domain=baiidu.com&apikey=PK-你的KEY

三、返回结果逐字段解释

返回的是 JSON（一种程序友好的文本格式），示例：

{ "ok": true, "domain": "baiidu.com", "level": "hold", "score": 45, "hits": [{ "type": "lookalike", "score": 45, "brand": "百度", "detail": "与「百度」官方域名高度相似（差异度 1）" }], "brand": null, "policy": "advisory", "sla_ms": 3, "engine": "dm-precheck/1.0", "time": "2026-10-02T21:00:00+08:00" }

ok：true=检测成功；
level：三级建议，最重要的字段：clear 放行 / flag 标记监控 / hold 建议人工复核后再完成注册；
score：风险加权分（0 起，越高越危险。≥15 为 flag，≥35 为 hold）；
hits：命中证据数组——type 是命中类型（lookalike=拼写仿冒 / decorated=装饰仿冒 / samename=同主域不同后缀 / numeric-1=数字替换 / embedded=品牌词嵌入 / keywords=诱导词 / free-tld=免费后缀 / susp-tld=高危后缀 / punycode=同形字编码），brand 是被仿冒品牌，detail 是给人看的解释；
brand：若该域名本身就是认证品牌的官方域名，此处显示品牌名（这种情况 level 必为 clear，直接放行）；
policy：固定 advisory，表示"建议制"；
sla_ms：本次耗时毫秒数；cached：true 表示来自缓存（同域名 24 小时内重复查询不重新计算）。

四、三级建议怎么落地处置（推荐流程）

clear → 正常完成注册，纳入常规监测即可；
flag → 建议放行但：① 将该域名列入贵机构重点监控名单（解析异动、批量注册行为）；② 对注册人加强实名核验（如要求补充材料）；③ 高风险后缀（.tk/.xyz 等）可附加冷静期；
hold → 建议：暂缓完成注册，人工核实注册主体资质（企业证照/商标权/授权链）；核实无误后照常注册（误伤救济见第六节）。若注册人系恶意，可将域名同步至平台处置通道（sec@dimiao.cn）。

嵌入注册系统的最小伪代码：
result = 调用接口(domain, apikey)
if (result.ok == false) → 按 clear 放行（见第五节）
if (result.level == "hold") → 转人工审核队列
elseif (result.level == "flag") → 注册成功但写入监控名单
else → 正常完成注册

五、错误代码与故障兜底（务必实现）

401 missing api key：没传 KEY（检查配置）；
403 invalid or disabled api key：KEY 错误或已被停用（联系平台管理员重置）；
429 rate limit：超出配额（默认 600 次/小时，联系平台提升）；
400 invalid domain：域名格式非法（您的系统应先校验格式）；
网络超时/5xx：必须按 clear 放行——前置检测是增强建议，绝不能因接口异常阻塞正常用户注册（标准第二十二条约定）。

六、误判与救济

品牌库 2500+，启发式比对存在极小概率误伤（如同名企业）。hold 级误伤处理：注册人可经平台「人工辅助研判」申诉（3 个工作日反馈），确认误伤后该域名永久豁免；贵机构亦可将案例反馈 sec@dimiao.cn 优化模型。

七、CT 流监测（无需对接，额外受益）

平台持续监测全球证书透明度日志流——即使域名在贵机构之外注册，只要签了 TLS 证书且仿冒工作组成员品牌，平台主动预警并复核入库。贵机构可订阅 sec@dimiao.cn 获取与贵司 TLD/客户相关的仿冒域名周报。