API 文档
文档目录
服务与支持 API 文档 修改域名共享
修改域名共享

1. 接口描述

本接口 Domainshare.Modify 用于修改域名共享。
接口请求地址:https://dnsapi.cn/Domainshare.Modify
HTTP请求方式:POST

2. 请求参数

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

参数名 是否必须 参数描述
domain_id 或 domain 分别对应域名ID和域名, 提交其中一个即可
email 被共享者的邮箱, 原来是什么就提交什么, 不能修改
mode 共享模式,”r”、”rw” 分别代表只读和读取、修改, 默认为 r
sub_domain 子域名共享, 如:www、bbs等. 如果要共享整个域名, 则无需提交此参数
old_sub_domain 已经成功共享的子域名, 如果只修改主域名共享, 则无需提交此参数
new_sub_domain 要修改到的共享子域名

3. 响应代码

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

响应码 描述
-15 域名已被封禁
6 域名ID错误
7 非域名所有者
8 域名id无效
13 当前域名有误,请返回重新操作
21 域名被锁定
23 子域名级数超出限制
24 泛解析级数超出限制

4. 示例

  1. 修改主域名共享状态, 从rw 修改为 r
curl -X POST https://dnsapi.cn/Domainshare.Modify -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&email=yizerowu@dnspod.com&mode=r'
  1. 修改子域名的共享状态, 从rw 修改为r
curl -X POST https://dnsapi.cn/Domainshare.Modify -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&email=yizerowu@dnspod.com&mode=r&old_sub_domain=www&new_sub_domain=www'
  1. 将主域名共享修改为子域名共享。
curl -X POST https://dnsapi.cn/Domainshare.Modify -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&email=yizerowu@dnspod.com&mode=rw&new_sub_domain=www'
  1. 将子域名共享修改为主域名共享。
curl -X POST https://dnsapi.cn/Domainshare.Modify -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&email=yizerowu@dnspod.com&mode=rw&old_sub_domain=www'
  1. www的子域名共享修改为bbs的子主域名共享。
curl -X POST https://dnsapi.cn/Domainshare.Modify -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2059079&email=yizerowu@dnspod.com&mode=rw&old_sub_domain=www&new_sub_domain=bbs'

返回示例如下:

  • JSON:
{
    "status": {
        "code": "1",
        "message": "Action completed successful",
        "created_at": "2015-01-18 18:54:18"
    }
}
最近更新于 2020-09-08 10:14