WHOIS 响应数据与质量

WHOIS 数据因注册局、TLD 与来源而异。确切的已发布 Schema 见 API 参考。即使示例中有值，可选字段仍应按可选字段处理。

先判断注册状态

单域名查询成功时，检查 data.registration.registered。明确已注册和明确未注册都属于成功查询。未知或不确定的结果不能证明域名尚未注册或可购买。

读取批量结果分页时，检查每一行的 status、state 与可选的 error_code。页面的 HTTP 成功只说明分页已返回，单个域名查询仍可能失败或无法确定。

处理缺失和被隐去的字段

注册局政策与来源可用性可能限制日期、注册商、nameservers 和联系人数据。不要把缺失的可选字段当作空字符串，也不要据此判断域名未注册。

单域名结果中的 data.quality.warnings 会提示数据缺失或被隐去。保留“没有字段值”与“注册状态明确”之间的区别。不要把注册局自由文本或提示文案用作稳定的程序枚举；请使用参考文档中的结构化字段。

理解成功处理数量

WHOIS 以域名作为处理单位：

• 明确已注册与明确未注册的结果均计为成功查询。
• 同一批次中的重复域名规范化后只处理并计费一次，结果行仍保留原输入位置。
• 无效输入、未知结果、上游错误、超时和未执行的项不计费。
• 缓存命中仍可能属于成功查询。
• 取消会停止新任务；取消前已成功完成的项仍计入最终结算。

为相同域名另建批量任务属于新操作。使用相同幂等 Key重试原始提交，才能恢复已有操作。

用结算记录确认费用

不要根据响应行数或公开结果字段计算费用。重复输入和失败查询会使结果行数与最终计费数量不同。请查看控制台中的最终凭证和用量记录。

预留与结算见 Credits 与计费，任务恢复见批量查询，临时故障处理见错误与恢复。