DNSHE免费域名API v2.0完全参考子域名注册、DNS记录、配额与公开WHOIS查询5大端点详解【免费下载链接】DNSHE-FreeDomains DNSHE Official - Stable Free Subdomains for Developers. Support 180-day renewal window, Anycast DNS, and REST API. (us.ci, cc.cd, de5.net, ccwu.cc)项目地址: https://gitcode.com/gh_mirrors/dn/DNSHE-FreeDomains**DNSHE免费域名APIv2.0**让你通过程序化管理免费子域名的完整生命周期注册、DNS记录配置、续期、配额查询、WHOIS查询全部收敛在5大端点组内。只需一个API Key就能把免费域名接入你的脚本、CI/CD和部署流程。本文用面向新手的方式讲清楚认证方式、每个端点的用法和常见错误处理。 什么是DNSHE免费域名APIDNSHE是由一支新加坡青年公益团队打造的免费子域名注册与DNS解析服务为开发者、学生和开源项目提供免费、稳定、易用的域名基础设施支持Anycast DNS和180天续期窗口完整支持A、AAAA、CNAME、MX、TXT、NS、SRV、CAA等记录类型。项目简介见README_ZH.md。API面向自动化场景设计脚本、CI/CD流水线、部署流程、测试环境和证书自动化都能直接调用。 开放注册后缀一览后缀推荐用途.de5.net技术博客、作品集、演示站、开源项目.us.ciCI/CD、SaaS、API端点、测试环境.cc.cd个人品牌、设计工作室、创意项目.bot.cdAI Bot、聊天助手、Webhook自动化项目登录控制台后可能还有更多后缀可用。来源README_ZH.md 认证配置3步创建你的API Key登录DNSHE客户区进入「我的域名管理」左侧导航点击「API管理」创建API密钥v2.0版本所有请求都基于统一的基础地址并在HTTP请求头中携带两把钥匙项目说明API地址https://api005.dnshe.com/index.php?mdomain_hub认证方式X-API-KeyX-API-Secret请求头返回格式JSON速率限制默认60请求/分钟可配置⚠️安全提醒出于安全考虑v2.0已禁止通过URL参数或请求体传递api_key/api_secret只支持请求头方式。最基础的一次调用列出子域名长这样curl -X GET https://api005.dnshe.com/index.php?mdomain_hubendpointsubdomainsactionlist \ -H X-API-Key: cfsd_xxxxxxxxxx \ -H X-API-Secret: yyyyyyyyyyyy后面所有端点都是同样的套路只需替换endpoint和action两个参数。1️⃣ 端点一子域名管理——注册、续期、删除免费子域名端点subdomains包含5个动作覆盖子域名全生命周期动作方法说明listGET列出账户下所有子域名registerPOST注册新子域名传subdomainrootdomaingetGET查询单个子域名详情传subdomain_iddeletePOST删除子域名传subdomain_idrenewPOST续期子域名传subdomain_id注册子域名示例curl -X POST https://api005.dnshe.com/index.php?mdomain_hubendpointsubdomainsactionregister \ -H X-API-Key: cfsd_xxxxxxxxxx -H X-API-Secret: yyyyyyyyyyyy \ -H Content-Type: application/json \ -d {subdomain: myapp, rootdomain: example.com}成功响应是JSON包含子域名列表每条记录带id、subdomain、full_domain、status字段{ success: true, count: 2, subdomains: [ { id: 1, subdomain: test, rootdomain: example.com, full_domain: test.example.com, status: active } ] } 子域名到期前调用renew即可续期无需手动登录控制台操作。完整端点规范见docs/api_zh.md。2️⃣ 端点二DNS记录管理——2个动作搞定A记录与CNAME端点dns_records包含2个动作动作方法说明listGET列出某个子域名的所有DNS记录传subdomain_idcreatePOST创建DNS记录传subdomain_idtypecontentDNSHE支持A、AAAA、CNAME、MX、TXT、NS、SRV、CAA等记录类型。创建一条A记录示例curl -X POST https://api005.dnshe.com/index.php?mdomain_hubendpointdns_recordsactioncreate \ -H X-API-Key: cfsd_xxxxxxxxxx -H X-API-Secret: yyyyyyyyyyyy \ -H Content-Type: application/json \ -d {subdomain_id: 1, type: A, content: 192.168.1.100}规范详见docs/api_zh.md。3️⃣ 端点三API密钥管理——列出与轮换你的密钥端点keys。用actionlist可列出账户当前所有API密钥丢失密钥或需要轮换时使用regenerate动作重新生成不用等客服。curl -X GET https://api005.dnshe.com/index.php?mdomain_hubendpointkeysactionlist \ -H X-API-Key: cfsd_xxxxxxxxxx -H X-API-Secret: yyyyyyyyyyyy规范详见docs/api_zh.md。4️⃣ 端点四配额查询——随时检查免费子域名余额端点quota。一次GET即可查到已注册数量和剩余可注册额度帮你判断还能注册多少个子域名curl -X GET https://api005.dnshe.com/index.php?mdomain_hubendpointquota \ -H X-API-Key: cfsd_xxxxxxxxxx -H X-API-Secret: yyyyyyyyyyyy 脚本里批量注册子域名前建议先查一次配额避免白白发请求。规范详见docs/api_zh.md。5️⃣ 端点五公开WHOIS查询——免认证秒查域名信息端点whois是5大端点中唯一不需要API Key的公开接口传上域名即可直接查询curl -X GET https://api005.dnshe.com/index.php?mdomain_hubendpointwhoisdomainfoo.example.com非常适合在脚本里快速核验一个域名是否已被占用、归属谁。规范详见docs/api_zh.md。 常见错误码与限流处理v2.0所有错误都采用统一结构success为false并附带error_code和message方便程序判断{ success: false, error_code: auth_invalid_credentials, message: Invalid API key }触发速率限制默认60请求/分钟时会返回rate_limit_exceededdetails里包含limit上限和remaining剩余{ error_code: rate_limit_exceeded, details: { limit: 60, remaining: 0 } } 建议在脚本里对限流错误做简单延时重试避免连续失败。错误结构与限流详见docs/api_zh.md。 安全最佳实践清单✅ API密钥存入环境变量绝不提交到公开仓库✅ 生产环境密钥开启IP白名单✅定期轮换密钥用regenerate动作✅ 始终使用HTTPS❓ 常见问题QAPI密钥丢失了怎么办A使用regenerate动作重新生成即可无需联系客服。Q支持批量操作吗A当前版本暂不支持可用循环逐个调用注意遵守速率限制。Qv2.0相比v1.0有什么升级A优化了API命令结构、新增部分功能接口、提升分页与查询性能、强化了错误结构与安全机制2026-04-25发布。详见docs/api_zh.md。 相关资料API文档中文docs/api_zh.mdAPI文档英文docs/api.md项目说明README_ZH.md【免费下载链接】DNSHE-FreeDomains DNSHE Official - Stable Free Subdomains for Developers. Support 180-day renewal window, Anycast DNS, and REST API. (us.ci, cc.cd, de5.net, ccwu.cc)项目地址: https://gitcode.com/gh_mirrors/dn/DNSHE-FreeDomains创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
DNSHE免费域名API v2.0完全参考：子域名注册、DNS记录、配额与公开WHOIS查询5大端点详解
DNSHE免费域名API v2.0完全参考子域名注册、DNS记录、配额与公开WHOIS查询5大端点详解【免费下载链接】DNSHE-FreeDomains DNSHE Official - Stable Free Subdomains for Developers. Support 180-day renewal window, Anycast DNS, and REST API. (us.ci, cc.cd, de5.net, ccwu.cc)项目地址: https://gitcode.com/gh_mirrors/dn/DNSHE-FreeDomains**DNSHE免费域名APIv2.0**让你通过程序化管理免费子域名的完整生命周期注册、DNS记录配置、续期、配额查询、WHOIS查询全部收敛在5大端点组内。只需一个API Key就能把免费域名接入你的脚本、CI/CD和部署流程。本文用面向新手的方式讲清楚认证方式、每个端点的用法和常见错误处理。 什么是DNSHE免费域名APIDNSHE是由一支新加坡青年公益团队打造的免费子域名注册与DNS解析服务为开发者、学生和开源项目提供免费、稳定、易用的域名基础设施支持Anycast DNS和180天续期窗口完整支持A、AAAA、CNAME、MX、TXT、NS、SRV、CAA等记录类型。项目简介见README_ZH.md。API面向自动化场景设计脚本、CI/CD流水线、部署流程、测试环境和证书自动化都能直接调用。 开放注册后缀一览后缀推荐用途.de5.net技术博客、作品集、演示站、开源项目.us.ciCI/CD、SaaS、API端点、测试环境.cc.cd个人品牌、设计工作室、创意项目.bot.cdAI Bot、聊天助手、Webhook自动化项目登录控制台后可能还有更多后缀可用。来源README_ZH.md 认证配置3步创建你的API Key登录DNSHE客户区进入「我的域名管理」左侧导航点击「API管理」创建API密钥v2.0版本所有请求都基于统一的基础地址并在HTTP请求头中携带两把钥匙项目说明API地址https://api005.dnshe.com/index.php?mdomain_hub认证方式X-API-KeyX-API-Secret请求头返回格式JSON速率限制默认60请求/分钟可配置⚠️安全提醒出于安全考虑v2.0已禁止通过URL参数或请求体传递api_key/api_secret只支持请求头方式。最基础的一次调用列出子域名长这样curl -X GET https://api005.dnshe.com/index.php?mdomain_hubendpointsubdomainsactionlist \ -H X-API-Key: cfsd_xxxxxxxxxx \ -H X-API-Secret: yyyyyyyyyyyy后面所有端点都是同样的套路只需替换endpoint和action两个参数。1️⃣ 端点一子域名管理——注册、续期、删除免费子域名端点subdomains包含5个动作覆盖子域名全生命周期动作方法说明listGET列出账户下所有子域名registerPOST注册新子域名传subdomainrootdomaingetGET查询单个子域名详情传subdomain_iddeletePOST删除子域名传subdomain_idrenewPOST续期子域名传subdomain_id注册子域名示例curl -X POST https://api005.dnshe.com/index.php?mdomain_hubendpointsubdomainsactionregister \ -H X-API-Key: cfsd_xxxxxxxxxx -H X-API-Secret: yyyyyyyyyyyy \ -H Content-Type: application/json \ -d {subdomain: myapp, rootdomain: example.com}成功响应是JSON包含子域名列表每条记录带id、subdomain、full_domain、status字段{ success: true, count: 2, subdomains: [ { id: 1, subdomain: test, rootdomain: example.com, full_domain: test.example.com, status: active } ] } 子域名到期前调用renew即可续期无需手动登录控制台操作。完整端点规范见docs/api_zh.md。2️⃣ 端点二DNS记录管理——2个动作搞定A记录与CNAME端点dns_records包含2个动作动作方法说明listGET列出某个子域名的所有DNS记录传subdomain_idcreatePOST创建DNS记录传subdomain_idtypecontentDNSHE支持A、AAAA、CNAME、MX、TXT、NS、SRV、CAA等记录类型。创建一条A记录示例curl -X POST https://api005.dnshe.com/index.php?mdomain_hubendpointdns_recordsactioncreate \ -H X-API-Key: cfsd_xxxxxxxxxx -H X-API-Secret: yyyyyyyyyyyy \ -H Content-Type: application/json \ -d {subdomain_id: 1, type: A, content: 192.168.1.100}规范详见docs/api_zh.md。3️⃣ 端点三API密钥管理——列出与轮换你的密钥端点keys。用actionlist可列出账户当前所有API密钥丢失密钥或需要轮换时使用regenerate动作重新生成不用等客服。curl -X GET https://api005.dnshe.com/index.php?mdomain_hubendpointkeysactionlist \ -H X-API-Key: cfsd_xxxxxxxxxx -H X-API-Secret: yyyyyyyyyyyy规范详见docs/api_zh.md。4️⃣ 端点四配额查询——随时检查免费子域名余额端点quota。一次GET即可查到已注册数量和剩余可注册额度帮你判断还能注册多少个子域名curl -X GET https://api005.dnshe.com/index.php?mdomain_hubendpointquota \ -H X-API-Key: cfsd_xxxxxxxxxx -H X-API-Secret: yyyyyyyyyyyy 脚本里批量注册子域名前建议先查一次配额避免白白发请求。规范详见docs/api_zh.md。5️⃣ 端点五公开WHOIS查询——免认证秒查域名信息端点whois是5大端点中唯一不需要API Key的公开接口传上域名即可直接查询curl -X GET https://api005.dnshe.com/index.php?mdomain_hubendpointwhoisdomainfoo.example.com非常适合在脚本里快速核验一个域名是否已被占用、归属谁。规范详见docs/api_zh.md。 常见错误码与限流处理v2.0所有错误都采用统一结构success为false并附带error_code和message方便程序判断{ success: false, error_code: auth_invalid_credentials, message: Invalid API key }触发速率限制默认60请求/分钟时会返回rate_limit_exceededdetails里包含limit上限和remaining剩余{ error_code: rate_limit_exceeded, details: { limit: 60, remaining: 0 } } 建议在脚本里对限流错误做简单延时重试避免连续失败。错误结构与限流详见docs/api_zh.md。 安全最佳实践清单✅ API密钥存入环境变量绝不提交到公开仓库✅ 生产环境密钥开启IP白名单✅定期轮换密钥用regenerate动作✅ 始终使用HTTPS❓ 常见问题QAPI密钥丢失了怎么办A使用regenerate动作重新生成即可无需联系客服。Q支持批量操作吗A当前版本暂不支持可用循环逐个调用注意遵守速率限制。Qv2.0相比v1.0有什么升级A优化了API命令结构、新增部分功能接口、提升分页与查询性能、强化了错误结构与安全机制2026-04-25发布。详见docs/api_zh.md。 相关资料API文档中文docs/api_zh.mdAPI文档英文docs/api.md项目说明README_ZH.md【免费下载链接】DNSHE-FreeDomains DNSHE Official - Stable Free Subdomains for Developers. Support 180-day renewal window, Anycast DNS, and REST API. (us.ci, cc.cd, de5.net, ccwu.cc)项目地址: https://gitcode.com/gh_mirrors/dn/DNSHE-FreeDomains创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
