域名搜索界面常从一份固定的常见后缀列表开始。注册商支持更多后缀、调整目录或无法确认某项结果时,这份列表就会产生误导。IaGenify SDK 0.3.3 增加了直接读取已连接注册商当前后缀目录的方式。
向 API 查询当前支持的后缀
新的 `api.domains.tlds()` 方法从服务读取可用目录。应用可以据此构建筛选器、目录或建议列表,而不必发布一份逐渐偏离供应商实际覆盖范围的固定清单。
const extensions = await api.domains.tlds();
const results = await api.domains.search("studio", {
tlds: ["com", "design", "studio"],
});查询一个后缀,或比较多个后缀
搜索方法接受名称和可选的后缀列表。开发者可以查询完整域名,也可以用短名称在多个后缀之间比较。目录和搜索既可支持简单输入框,也可支持完整的比较表格。
可用不等于预留
搜索结果反映查询时的可用状态。它不会预留名称、完成注册,也不能保证之后结果不变。SDK 保持这条边界清晰:它负责目录发现和搜索;注册与付款属于 IaGenify 产品中的独立明确流程。
这对界面表达很重要。未知的可用状态应继续显示为未知,而不是标成绿色;搜索结果也不应被说成购买确认。应用可以展示供应商返回的信息,并把下单留给单独确认的步骤。
用注册商当前目录指导选择;由下单流程完成购买。
借助 0.3.3,域名应用可以从同一服务获取后缀选项并进行搜索。这项小改动减少过时假设,并明确区分名称查询与域名注册。
常见问题
`api.domains.tlds()` 是 SDK 内置的固定列表吗?
不是。它读取 IaGenify API 当前连接注册商提供的后缀目录。
可以查询完整域名吗?
可以。`api.domains.search()` 接受完整域名,也接受名称和后缀列表。
显示可用就代表域名已预留吗?
不代表。它只报告查询时的可用状态,不会预留或注册名称。
这个方法能完成购买吗?
不能。它用于发现目录和搜索;注册与付款需要单独且明确确认的流程。