域名管理 API

管理后台：域名相关接口，需管理员会话。

创建域名

接口地址：

• /domain/create

HTTP请求方式

• POST

请求参数

• domain (form, required): 根域名，如 example.com

• type (form, required): 类型，0 或 1

响应代码

• 0: 成功

• 1: 参数错误、无权限、域名已存在等

示例:

curl -X POST "$BASE_URL/domain/create" -d "domain=example.com&type=0"

响应示例：

• JSON:

  { "code": 0, "message": "域名创建成功", "data": {} }
  

列出域名

接口地址：

• /domain/list

HTTP请求方式

• GET

请求参数

响应代码

• 共通响应

响应示例：

• JSON:

  {
    "data": [
      { "domain": "example.com", "url": "/domain/detail/example.com", "valid": "1", "type": 0 }
    ],
    "code": 0,
    "message": "OK"
  }
  

获取域名详情

接口地址：

• /domain/info/:domain

HTTP请求方式

• GET

请求参数

• domain (path): 域名

响应代码

• 共通响应

响应示例：

• JSON:

  {
    "data": {
      "ID": 1,
      "domain": "example.com",
      "type": 0,
      "valid": true,
      "dkim_pub_key": "...",
      "dkim_record": "...",
      "spf_record": "...",
      "mxa_record": "...",
      "mxb_record": "...",
      "dmarc_record": "...",
      "hostname": "...",
      "inbox_rules": "...",
      "spf_valid": true,
      "dkim_valid": true,
      "dmarc_valid": true,
      "mxa_valid": true,
      "mxb_valid": true
    },
    "code": 0,
    "message": "OK"
  }
  

删除域名

接口地址：

• /domain/delete

HTTP请求方式

• POST

请求参数

• domain (form, required): 域名

响应代码

• 0: 成功

• 1: 参数错误、无权限等

示例:

curl -X POST "$BASE_URL/domain/delete" -d "domain=example.com"

检查域名 DNS

接口地址：

• /domain/checkdns

HTTP请求方式

• POST

请求参数

• domain (form, required): 域名

响应代码

• 0: 检查成功（含各记录是否通过）

• 1: 参数错误或检查失败

响应示例：

• JSON:

  {
    "data": {
      "valid": true,
      "dkim_valid": true,
      "mxa_valid": true,
      "mxb_valid": true,
      "dmarc_valid": true,
      "spf_valid": true,
      "current_mxa_record": "...",
      "current_mxb_record": "...",
      "current_spf_record": "...",
      "current_dkim_record": "...",
      "current_dmarc_record": "...",
      "hostName": "...",
      "cache_time": "300s"
    },
    "code": 0,
    "message": "检查DNS记录成功"
  }
  

更新域名收信规则

接口地址：

• /domain/inboxrules/:domain

HTTP请求方式

• POST

请求参数

• domain (path): 域名

• domain (form, required): 同上

• rule (form, required): 收信规则，多行，每行格式为「条件,动作,收件人」，收件人不能为本域

响应代码

• 0: 成功

• 1: 域名未通过 DNS 验证或规则格式错误

示例:

curl -X POST "$BASE_URL/domain/inboxrules/example.com" -d "domain=example.com&rule=..."

响应示例：

• JSON:

  { "data": { "ID": 1, "domain": "example.com", "type": 0, "valid": "1", "hostname": "...", "inbox_rules": "..." }, "code": 0, "message": "更新域名收信规则成功" }
  

页面路由（非 JSON API）

• GET /domain - 域名管理页

• GET /domain/detail/:domain - 域名详情页

• GET /domain/inboxrules/:domain - 收信规则页

• GET /domain/delete/:domain - 删除域名确认页