用户接口(API)

用程序管理域名,而不是逐条点页面。

把域名注册、查询、解析和管理接进你自己的系统:批量下单、自动化续费巡检、给客户的自助控制台,都可以走接口完成。

接口提供的是管理能力的机器入口,与客户中心里能做的事一一对应;你在页面上能做的操作,基本都能用接口完成。

REST 基于 HTTPS 的 JSON 接口
API Key 密钥在客户中心生成与管理
一一对应 与客户中心功能对应的操作
可审计 接口调用写入账户日志

这是什么

  • 接口按资源组织:域名查询、域名管理、名称服务器、联系人、订单与发票各有对应端点,返回 JSON。
  • 认证使用你在客户中心生成的 API 密钥,密钥随时可以作废并重新生成。
  • 适合的场景:批量注册与续费巡检、把域名状态同步到自己的系统、为客户提供自助面板、自动化证书签发流程。
  • 接口调用同样受业务规则约束——域名不能凭空注册,转移仍需满足解锁与 60 天等条件。

如何运作

01

生成密钥

在客户中心的接口设置里创建 API 密钥,并限定用途。

02

读文档

查看接口说明,确认端点、参数与返回结构。

03

沙盒验证

先用少量域名或只读端点验证调用与错误处理。

04

投入生产

加上重试与日志,再接入正式流程。

域名查询与可用性

批量查询注册状态,适合选词与监控。

注册与续费

下单、续费、查询订单状态。

DNS 与名称服务器

批量下发解析记录与 NS 配置。

联系人管理

读取与更新注册人、管理、技术、账单联系人。

订单与发票

拉取订单、发票与付款状态。

密钥可轮换

密钥可随时作废重建,权限按需最小化。

接口能做什么

按资源划分的能力范围

资源可以做什么
域名查询可用性、注册、续费、查看状态与到期日
解析读取与设置名称服务器、维护 DNS 记录
隐私与联系人设置隐私级别、更新四类联系人资料
订单与账单查询订单、发票与付款状态
账户查询余额与基本信息

接入前要准备什么

四件小事,省掉后面大半的排错时间

  • 账户余额或可用的支付方式:注册与续费走的是真实下单流程,余额不足会在下单这一步失败。
  • 错误处理与重试:网络抖动、限流与上游延迟都可能发生,请对幂等接口做重试,对下单类接口用唯一请求号避免重复注册。
  • 日志:把请求号、域名、响应码记录下来。出现争议时,这些日志是唯一能证明动作发生过的东西。
  • 权限最小化:只读场景不要用可写密钥;不同系统用不同密钥,便于单独作废。

API 密钥等同于账户密码。请把它放在服务端的环境变量或密钥管理服务里,不要写进前端代码、不要提交到代码仓库。

常见的使用方式

别人是怎么用它的

  • 批量注册系统:把选词结果批量提交注册,并把结果回写到自己后台。
  • 续费巡检:每天拉取即将到期的域名,按自定义规则生成续费或提醒任务。
  • 客户自助面板:白标场景下,让客户在你的系统里管理域名,而不用登录我们的客户中心。
  • 合规与对账:定期导出域名与订单数据,与内部台账核对。

每笔订单包含什么

API 密钥管理

自助生成、作废与按用途区分密钥。

接口说明文档

端点、参数与返回结构说明。

域名与解析接口

查询、注册、续费、DNS 与 NS。

订单与账单接口

订单、发票与付款状态。

调用记录

接口调用写入账户日志便于排查。

技术支持

接入中遇到问题可提交工单。

常见问题

接口要额外付费吗?

接口本身不单独收费,按下单产生的实际业务计费。调用频率有合理上限,用于防止误用与滥用。

有现成的 SDK 吗?

接口是标准的 HTTPS + JSON,用任何语言的 HTTP 客户端都能调用。文档里给出了请求示例,可以直接改写。

密钥泄露了怎么办?

立即在客户中心作废该密钥并生成新的。作废即时生效,使用旧密钥的请求会立即被拒绝。

测试时会不会产生费用?

查询类接口不产生费用;注册与续费是真实下单,会产生费用。建议先在少量域名上验证逻辑。

接口能管理不在 Ry.hk 注册的域名吗?

不能。接口只能操作 Ry.hk 账户下的域名,这与客户中心一致。

请注意

  • API 密钥请保存在服务端,不要放进浏览器端代码或移动端包内。密钥一旦公开就等同账户失守。
  • 下单类接口请使用唯一请求号并在写入前判重,避免网络重试导致重复注册、重复付费。

准备好了吗?

打开对应页面,几步就能完成;需要人帮忙时,工单与邮箱都在。