技能介绍

为什么需要反查域名 IP

排查线上故障时，常见的问题是“这个域名到底解析到哪个 IP”。变更回滚、CDN 切换、服务器迁移后，仅凭当前 nslookup 可能已经看不到历史记录，缺少解析变更的时间线。这个技能用于按域名反向查询其解析到的 IP 地址，以及这些解析记录的类型与时间范围，帮助开发者和运维快速还原 DNS 解析历史，而不是手动去翻分散的日志。

核心能力与执行流程

查询域名解析 IP：给出一个域名后，返回该域名当前关联的 IP 地址，无需额外拼接命令或轮询多个接口。
区分 IPv4/IPv6：在返回结果中标注解析类型为 IPv4 或 IPv6，便于定位是双栈切换还是单栈遗留配置。
提供解析时间戳：返回 firstFind（首次解析成功）与 lastFind（最后解析成功）两个 Unix 时间戳字段，可直接换算成具体日期，用于判断变更频率与变更窗口。

执行流程是：从用户请求里提取查询参数（域名与页码）；在技能根目录调用执行脚本，脚本会携带 API Key 向接口发起请求；读取脚本输出的 JSON 结果后，仅根据实际返回字段组装答复。响应中 StateCode 为 1 表示成功，结果包含 Result.TotalCount（总数量）、Result.TotalPage（总页数）、当前页 Result.List 中的 IP、类型和时间戳。每页最多返回 10 条记录，总量超过 10 条时通过 page 参数翻页。

适用边界与注意事项

单域名查询：一次请求只处理一个域名，批量任务需要逐条执行。
不越界使用：本技能只覆盖“域名反查 IP”接口，不做 IP 归属地查询、Whois 查询或域名注册信息查询。
数据仅供参考：返回结果用于了解解析历史与排查线索，排名类数据存在异地差异。
API Key 管理：Key 仅用于本次查询，回复中不要回显完整密钥，也不要写入公开日志。
错误处理：遇到 missing_api_key 时，需要提示用户去获取并重新提供；遇到 invalid_input 先校验域名格式；network_error 或 timeout 时先排查网络、DNS、代理或防火墙配置。