尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
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),仅供参考
RELATED

相关推荐

5 分钟跑通 DeepTutor 深度研究:从一个提问到带引用的报告

5 分钟跑通 DeepTutor 深度研究:从一个提问到带引用的报告

5 分钟跑通 DeepTutor 深度研究:从一个提问到带引用的报告 【免费下载链接】DeepTutor DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/. 项目地址: https://gitcode.com/GitHub_Trending/dee/DeepTutor 查文献最费时间的环节&#xff…

📅 2026/11/2 7:25:14
yuzu 模拟器完全入门指南:从克隆源码到跑起第一个 Switch 游戏的 6 步

yuzu 模拟器完全入门指南:从克隆源码到跑起第一个 Switch 游戏的 6 步

yuzu 模拟器完全入门指南:从克隆源码到跑起第一个 Switch 游戏的 6 步 【免费下载链接】yuzu 任天堂 Switch 模拟器 项目地址: https://gitcode.com/GitHub_Trending/yu/yuzu yuzu 是一款主流的开源任天堂 Switch 模拟器,用 C 编写,官…

📅 2026/11/2 7:25:53
OpenCV 4.11源码编译CUDA 12.1+cuDNN 8.9.7完整指南

OpenCV 4.11源码编译CUDA 12.1+cuDNN 8.9.7完整指南

简介:这是一套面向 Windows 11 x64 平台的 OpenCV 4.11 预编译开发包,基于 Visual Studio 2022 Release 配置,并已集成 CUDA 12.1、cuDNN 8.9.7 与 DNN 模块。对于希望在 C 工程中直接获得 GPU 加速能力的计算机视觉开发者而言,它…

📅 2026/10/8 19:36:26
MORE NEWS

更多资讯

📰

数学建模论文智能写作工具评测与优化策略

1. 数学建模论文写作痛点与智能工具需求分析数学建模竞赛论文写作长期存在三大核心痛点:公式编辑效率低下、数据可视化耗时费力、格式规范难以统一。传统LaTeX排版虽然专业但学习曲线陡峭,而Word在复杂公式处理上又显得力不从心。根据2023年全国大学生数…

📰

Unity AssetBundle解包原理与合规实践指南

1. 这不是“破解”,而是资源合规复用的必要技术动作 “Unity 3D 资源解包工具”这个短语在开发者社区里常年高频出现,但很多人一看到“解包”就下意识联想到灰色操作——其实完全误解了它的本质。它既不是针对商业软件的逆向攻击,也不是绕过…

📰

全栈性能部署:现代Web应用高效运行的关键

1. 全栈性能部署流程体系概述全栈性能部署流程体系是现代Web应用开发中确保系统高效稳定运行的关键方法论。这套体系贯穿前端、后端、数据库、网络等各个环节,通过标准化的流程和工具链,实现从代码提交到生产环境部署的全链路性能优化。在实际项目中&…

📰

无人机与边缘计算协同优化:轨迹、功率与资源匹配

1. 项目背景与核心挑战在移动边缘计算(MEC)与无人机协同的现代应用场景中,我们面临着三大核心挑战:如何规划无人机的高效飞行轨迹?如何动态调整传输功率以适应复杂环境?以及如何实现多无人机与多地面用户&a…

📰

2026年Github热门开源项目盘点:AI工具链与开发者体验革新

1. 项目概述:2026年第11周Github热门开源项目盘点每周追踪Github趋势榜已经成为开发者获取技术风向标的必修课。2026年第11周(3月14日-3月20日)的榜单呈现出明显的AI工具链优化、新型编程范式、以及开发者体验升级三大特征。与往年同期相比&a…

📰

微电网中光伏与空调负荷的优化控制策略

1. 项目背景与核心价值去年夏天参与某工业园区微电网项目时,我亲历了这样一个场景:当光伏发电达到峰值时,配电变压器却因空调集中启动导致过载跳闸。这个典型矛盾促使我开始深入研究如何协调可再生能源波动与空调负荷的关系。这项研究本质上要…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬