1. 接口描述

本接口 Domainshare.List 用于域名共享列表。
接口请求地址：https://dnsapi.cn/Domainshare.List
HTTP请求方式：POST

2. 请求参数

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

参数名	是否必须	参数描述
domain_id 或 domain	是	分别对应域名ID和域名, 提交其中一个即可。

3. 响应代码

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

响应码	描述
6	域名ID错误。
7	非域名所有者。
8	域名无效、VIP域名不可以删除。
13	当前域名有误，请返回重新操作。

4. 示例

curl -X POST https://dnsapi.cn/Domainshare.List -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079'

返回示例如下：

JSON:

{
    "status": {
        "code": "1",
        "message": "Action completed successful",
        "created_at": "2015-01-18 17:51:50"
    },
    "share": [
        {
            "share_to": "yizerowu@dnspod.com",
            "mode": "rw",
            "status": "enabled"
        }
    ],
    "owner": "api@dnspod.com"
}

字段说明:
share：域名的共享信息。
- share_to：共享给其他 DNSPod 的账号。
- mode：域名共享模式：
  - “rw”：可读写。
  - “r”:：只读。
- status：域名的共享状态：
  - “enabled”：共享成功。
  - “pending”：共享到的账号不存在, 等待注册。
owner：域名所有者的账号。