# IaGenify SDK 0.3.3：通过 API 查询支持的域名后缀。

Canonical URL: https://www.iagenify.com/zh/news/iagenify-sdk-033-domain-extension-discovery

SDK 可读取已连接注册商当前提供的后缀目录，并按选定 TLD 搜索名称，无需维护很快就会过时的硬编码列表。

## Key points
- `api.domains.tlds()` 读取 IaGenify 所连接注册商提供的后缀。
- `api.domains.search()` 可查询选定后缀或完整域名。
- 搜索只检查可用性，不会预留名称，也不代表 SDK 负责注册购买。

域名搜索界面常从一份固定的常见后缀列表开始。注册商支持更多后缀、调整目录或无法确认某项结果时，这份列表就会产生误导。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，域名应用可以从同一服务获取后缀选项并进行搜索。这项小改动减少过时假设，并明确区分名称查询与域名注册。

## FAQ
### `api.domains.tlds()` 是 SDK 内置的固定列表吗？
不是。它读取 IaGenify API 当前连接注册商提供的后缀目录。

### 可以查询完整域名吗？
可以。`api.domains.search()` 接受完整域名，也接受名称和后缀列表。

### 显示可用就代表域名已预留吗？
不代表。它只报告查询时的可用状态，不会预留或注册名称。

### 这个方法能完成购买吗？
不能。它用于发现目录和搜索；注册与付款需要单独且明确确认的流程。