域名查询与可用性
批量查询注册状态,适合选词与监控。
把域名注册、查询、解析和管理接进你自己的系统:批量下单、自动化续费巡检、给客户的自助控制台,都可以走接口完成。
接口提供的是管理能力的机器入口,与客户中心里能做的事一一对应;你在页面上能做的操作,基本都能用接口完成。
在客户中心的接口设置里创建 API 密钥,并限定用途。
查看接口说明,确认端点、参数与返回结构。
先用少量域名或只读端点验证调用与错误处理。
加上重试与日志,再接入正式流程。
批量查询注册状态,适合选词与监控。
下单、续费、查询订单状态。
批量下发解析记录与 NS 配置。
读取与更新注册人、管理、技术、账单联系人。
拉取订单、发票与付款状态。
密钥可随时作废重建,权限按需最小化。
按资源划分的能力范围
| 资源 | 可以做什么 |
|---|---|
| 域名 | 查询可用性、注册、续费、查看状态与到期日 |
| 解析 | 读取与设置名称服务器、维护 DNS 记录 |
| 隐私与联系人 | 设置隐私级别、更新四类联系人资料 |
| 订单与账单 | 查询订单、发票与付款状态 |
| 账户 | 查询余额与基本信息 |
四件小事,省掉后面大半的排错时间
API 密钥等同于账户密码。请把它放在服务端的环境变量或密钥管理服务里,不要写进前端代码、不要提交到代码仓库。
别人是怎么用它的
自助生成、作废与按用途区分密钥。
端点、参数与返回结构说明。
查询、注册、续费、DNS 与 NS。
订单、发票与付款状态。
接口调用写入账户日志便于排查。
接入中遇到问题可提交工单。
接口本身不单独收费,按下单产生的实际业务计费。调用频率有合理上限,用于防止误用与滥用。
接口是标准的 HTTPS + JSON,用任何语言的 HTTP 客户端都能调用。文档里给出了请求示例,可以直接改写。
立即在客户中心作废该密钥并生成新的。作废即时生效,使用旧密钥的请求会立即被拒绝。
查询类接口不产生费用;注册与续费是真实下单,会产生费用。建议先在少量域名上验证逻辑。
不能。接口只能操作 Ry.hk 账户下的域名,这与客户中心一致。