跳转到主要内容

注册商模块配置

模块安装完成后，需要在 WHMCS 中激活它并输入您的 HostMyServers API 凭据。

激活模块​

  1. 登录 WHMCS 管理后台
  2. 导航至设置 → 系统 → 注册商模块
  3. 在列表中找到 HostMyServers
  4. 点击激活

模块现已激活，将显示配置表单。

连接设置​

激活后，填写以下字段：

API 密钥（API Key）​

从 hostmyservers.fr/user/api 生成的 API 密钥。在此页面，您可以创建密钥、为其命名（例如 WHMCS Production）并随时删除。请像对待密码一样对待此密钥：绝不分享，绝不提交到 Git 仓库。

API 密钥安全

如果您认为 API 密钥已泄露，请立即在 hostmyservers.fr/user/api 删除它并创建新密钥，然后在 WHMCS 模块配置中更新密钥。

如需沙盒凭据，请联系 HostMyServers 支持。

默认所有者联系人（Owner Contact）​

此字段定义注册每个域名时默认使用的所有者联系人。有两个选项：

选项 1 — 使用 HostMyServers 账户资料

勾选使用账户所有者（use_account_owner: true）。与 API 密钥关联的资料信息（姓名、地址、邮箱、电话）将自动用作所有者联系人。

选项 2 — 使用现有联系人

输入来自您 HostMyServers 联系人簿的联系人标识符（contact_id）。要获取可用联系人列表，请查询端点：

GET /domains/contacts

响应中列出了所有联系人及其 id，可复制到此字段中。

何时使用 contact_id？

如果您代表与主要资料不同的实体（例如独立公司、子公司）注册域名，请使用 contact_id。这样可以在不修改账户信息的情况下保持一致的所有者联系人。

测试连接​

输入凭据后，点击保存，然后点击测试连接按钮。WHMCS 将向 HostMyServers API 发出测试调用并显示结果：

  • 成功："连接成功。账户余额：XX.XX €" — 您的配置正常运行
  • 身份验证错误：检查 API 标识符和密钥
  • 连接错误：检查服务器是否可以访问 HostMyServers API（防火墙、cURL 已启用）

高级设置​

自动域名同步​

此设置启用域名状态和到期日期的定期同步。强烈建议保持启用，以维护 WHMCS 和 HostMyServers 之间的一致性。

推荐值：已启用

DNS 传播延迟（小时）​

修改名称服务器后向客户显示的时长，表示预计传播延迟。这没有技术影响。

默认值：24

在控制台显示余额​

启用后，WHMCS 管理控制台中会显示一个小部件，展示您的 HostMyServers 余额。

推荐值：已启用（有助于提前预判账户充值需求）

总结​

配置完成并通过连接测试后，您的 HostMyServers 注册商模块即可使用。进入下一步：扩展名管理。