API 文档
文档目录
服务与支持 API 文档 获取记录信息
获取记录信息

1. 接口描述

本接口 Record.Remark 用于获取记录信息。
接口请求地址:https://dnsapi.cn/Record.Info
HTTP请求方式:POST

2. 请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 公共请求参数页面。

参数名称 是否必选 描述
domain_id 或 domain 分别对应域名ID和域名, 提交其中一个即可。
record_id 记录ID。
remark 域名备注,删除备注请提交空内容。

3. 响应代码

以下参数列表仅列出了此接口响应代码,除此接口请求响应代码外。还包含 共通返回码

响应码 描述
6 域名 ID 错误。
7 记录开始的偏移无效、非域名所有者。
8 域名无效。
13 当前域名有误,请返回重新操作。

4. 示例

curl -X POST https://dnsapi.cn/Record.Info -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2317346&record_id=16894439'

返回示例如下:

  • JSON:
{
    "status": {
        "code": "1",
        "message": "Action completed successful",
        "created_at": "2016-08-12 17:51:25"
    },
    "domain": {
        "id": "9842292",
        "domain": "yizerowu.com",
        "domain_grade": "DP_Free"
        "dnspod_ns": [
          "ns3.dnsv3.com",
          "ns4.dnsv3.com"
        ]
    },
    "record": {
        "id": "44146112",
        "sub_domain": "yizerowwwww",
        "record_type": "A",
        "record_line": "联通",
        "record_line_id": "10=1",
        "value": "12.3.3.3",
        "weight": null,
        "mx": "0",
        "ttl": "600",
        "enabled": "1",
        "monitor_status": "",
        "remark": "",
        "updated_on": "2016-08-12 17:07:05",
        "domain_id": "9842292"
    }
}

字段说明:

  • domain:

  • id: 域名ID,即为 domain_id。

  • domain: 域名。

  • domain_grade: 域名等级,详见 Domain.List 或 Domain.Info 接口。

  • dnspod_ns: 域名等级对应的 ns 服务器地址。

  • record:

  • id: 记录ID编号。

  • sub_domain: 子域名(主机记录)。

  • record_type: 记录类型, 详见 Record.Type 接口。

  • record_line: 解析记录的线路, 详见 Record.Line 接口。

  • record_line_id: 解析记录的线路ID,详见 Record.Line 接口。

  • value: 记录值。

  • mx: 记录的 MX 记录值, 非 MX 记录类型,默认为 0。

  • ttl: 记录的 TTL 值。

  • enabled: 记录状态。

    • “0”: 禁用
    • “1”: 启用
  • monitor_status: 该记录的 D 监控状态。

    • “Ok”: 服务器正常。
    • “Warn”: 该记录有报警, 服务器返回 4XX。
    • “Down”: 服务器宕机。
    • “”: 该记录未开启D监控。
  • remark: 记录备注。

  • updated_on: 记录最后更新时间。

  • domain_id: 域名ID, 即为 domain_id。

最近更新于 2020-09-08 11:22