Dynadot 域名 API 概览——120+ 命令覆盖注册到交易的全流程
为什么 Dynadot API 特别重要
不是所有域名注册商都提供完整的 API。很多注册商的 API 只暴露最基础的查询和注册功能，DNS 修改、Smart Folders、二级市场操作等高级功能只能通过 Web 控制台手动完成。
Dynadot 的 API 是行业里最完整的之一：
- 120+ 命令：覆盖了 Web 控制台里能做的几乎所有事情
- RESTful JSON API（新版）：替代了旧版的 XML / 表单 API
- API Sandbox 沙箱：可以先在沙箱里测试，不会真的花钱
- Smart Folders 接口：唯一在 API 层面暴露文件夹操作的注册商
- Marketplace 接口：可以通过 API 参与拍卖、下 Backorder、挂牌出售、接受报价
- Reseller 接口：分销商可以通过 API 管理名下子账户的域名
API 的六大能力域
| 域 | 典型命令 | 说明 |
|---|---|---|
| Acquire（获取） | Register, Transfer, Renew | 通过 API 注册、转入、续费域名 |
| Discover（查询） | SearchDomain, Whois, GetDomainList | 批量查询域名可用性、获取账户域名列表 |
| Manage（管理） | SetDNS, SetWhois, LockDomain, SetFolder | 修改 DNS、Whois、锁定状态、分配文件夹 |
| Organize（组织） | CreateFolder, MoveDomainToFolder | Smart Folders 的创建和管理 |
| Aftermarket（市场） | PlaceAuctionBid, AddBackorder, ListDomain | 竞价、抢注、挂牌、报价处理 |
| Reseller（分销） | 子账户管理命令 | Dynadot Reseller 分销计划专用 |
快速示例
查询域名可用性
GET https://api.dynadot.com/api3.json?key=YOUR_API_KEY&command=search&domain=example.com批量获取账户所有域名
GET https://api.dynadot.com/api3.json?key=YOUR_API_KEY&command=list_domain给文件夹内所有域名改 DNS
curl -X POST https://api.dynadot.com/api3.json \
-d "key=YOUR_API_KEY" \
-d "command=set_dns" \
-d "folder_name=my-folder" \
-d "dns_type=custom" \
-d "ns=ns1.cloudflare.com" \
-d "ns=ns2.cloudflare.com"输出格式
所有 API 响应都是 JSON，结构：
{
"ResponseCode": 0,
"ResponseContent": {
// 具体命令的返回数据
}
}ResponseCode = 0 表示成功。非 0 表示错误，具体含义看 API 文档的错误码列表。
常见 API 使用场景
- 批量 DNS 修改：切换到 Cloudflare DNS，一次改完几十个域名
- 定时续费监控：写脚本每天检查账户域名到期时间，自动发提醒
- Smart Folders 自动化：注册新域名后自动按规则归入对应文件夹
- 二级市场竞价机器人：监控特定关键词域名的拍卖，自动竞价到预设上限
- Reseller 分销系统：把 Dynadot API 封装成自己的分销后台
API 文档位置
Dynadot 提供两套 API 文档：
- RESTful API（推荐）：新版 JSON API，入口在
api.dynadot.com/api3.json - Legacy API（旧版）：XML / 表单格式，功能基本覆盖但不如新版方便
两个版本都支持 API Sandbox 测试。
