POST参数注意事项: 所有电话号码及邮编必须为数字,且不能为零 本接口为GB2312字符集编码(如需使用UTF-8字符集编码,请在请求头Content-Type中增加charset=utf-8) 1. 文档说明 1.1 文档简介 本版本采用HTTPS POST方式进行注册。 1.2 使用限制 只有网维互联的会员才能使用。 必须符合接口认证方式才能提交命令。 注册接口按照该会员的价格进行实时注册实时扣费,如果预付款不足,将不能提交注册申请。 1.3 操作说明 1.API授权密码(登录我公司网站后在用户信息修改中可设置API授权码,同时填写您的授权访问IP)。 2.按照接口说明编写客户端程序向接口提交查询、注册命令、续费管理操作,立刻获得结果。 1.4 域名范围 网维互联站内在售所有中英文域名。 2. 接口概述 2.1 接口目录 Check接口:主要负责进行域名的查询,采用多线程方式,可以同时查询多个域名 Register 接口:注册接口,实时注册,成功后立即扣费。如果超时,不转为后台注册,域名将被删除。 Status接口:查询域名是否注册成功。 ModDns接口: 进行在线修改DNS操作。 DomainRenew续费接口:域名续费接口,实时续费,立即扣费。 GetProductKey获取产品密码接口:获取域名管理密码以及域名到期时间。 ChangeProductKey修改产品密码接口:修改域名管理密码。 ModifyContactor 接口:修改除域名所有人以外的所有联系人信息。 AddSelfDNS注册本域名下的DNS:注册本域名下的DNS。 GetSelfDNS查询本域名下的DNS:查询本域名下的DNS。 ModSelfDNS修改本域名下的DNS:修改本域名下的DNS。 DelSelfDNS删除本域名下的DNS:删除本域名下的DNS。 DomainDNSQuery解析记录查询接口:查询域名解析记录 DomainDNSAdd解析记录添加接口:添加解析记录 DomainDNSMod解析记录修改接口:修改解析记录 DomainDNSDel解析记录删除接口:删除解析记录 接口更多功能请搜索帮助中心 2.2 认证方式 1。IP限制,对于任何接口必须从该会员授权的IP,每个会员限授权 5 个IP地址 2。MD5非可逆加密摘要,除Check接口、和Status接口外,其它所有接口都要求提供(兼容md5后的API密码) 2.3 返回结果 按照POST数据格式返回数据结果 3. 接口说明 3.1 Check 接口 POST 地址: https://api.wvidc.com/domain/api.gb?method=check POST 参数: name 名字;1个,没有后缀 enc 编码,E,G;1个; suffix 后缀;1-N个,域名后缀.com/.net/.org/.中国/cnaddr/.公司/... client 会员名;1个 例如:name=abc&enc=E&suffix=.com&suffix=.net&suffix=.cn&client=username POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 返回结果: num 域名数量 enc 编码 name[1--N] 域名,名字+后缀 N=num chk[1--N] N=num 查询结果: 0 不可注册 50查询超时 100 可以注册 200 高价词 price[1--N] 域名价格,其中standard 标识普通价格域名否则价格为高价词域名出售价格 信息编码: auth-failure 认证失败 例如:num=3&enc=E&name1=abc.com&chk1=0&name2=abc.net&chk2=100&price2=standard&name3=abc.org&chk3=50 3.2 Register 接口 POST 地址: https://api.wvidc.com/domain/api.gb?method=Register POST 参数: [域名信息] dn 域名;1个,包括名字和后缀 enc 编码,E,G;1个; client 会员名;1个 checksum MD5加密摘要 period 注册年数;[如果不填默认为1年],有效值1-10年
[注册所有人或注册单位的信息] uname1 注册人中文单位名称 [必须] uname2 注册人英文单位名称 [必须] ----- 必须英文,且中间有一个空格 rname1 注册人|单位负责人中文名称[必须] rname2 注册人|单位负责人英文名称[必须] ----- 必须英文,且中间有一个空格 ust 注册人英文国家名称 两个字母[CN表示中国],接口自动翻译中文 uprov 注册人英文省份名称 如:Beijing,接口自动翻译中文 ucity1 注册人中文城市名称 [必须] ucity2 注册人英文城市名称 [必须] uaddr1 注册人中文地址 [必须] uaddr2 注册人英文地址 [必须] uzip 注册人邮政编码 [必须] utelc 注册人电话国家码, 如:86,长度不能大于3位 utela 注册人电话区号 如果为手机可以不填,此项不可为0 uteln 注册人电话号码 (区号+电话号码长度必须小于12) ufaxc 注册人传真国家码, 如:86,长度不能大于3位 ufaxa 注册人传真区号 如果为手机可以不填,此项不可为0 ufaxn 注册人传真号码 必须为数字 (区号+传真号码长度必须小于12) uemail 注册人email地址 dns1 域名主服务器名字 [如果不填系统默认分配] dns2 域名辅服务器名字 [如果不填系统默认分配] dcpr 优先注册接口只能为数字 5、6、13、15、17、18 、19、21、22、23、24、25 [选填,系统默认接口] premium 只能为数字1,注册优质域名时必传 [选填] moneytmp 选填,用户购买价,当价格低于自己的代理价时,开通会失败,防止亏损。
例如:dn=abc.com&enc=E&client=agent111&uname1=%c1%f5%be%fe&uname2=liu+jun&period=1.... POST 数据,都必须进行GB2312的URL编码(空格编码成+号),否则中文信息将不正确 验证:client和POST的来源IP必须与该会员填写的IP地址一致 checksum=MD5("Register"+client+password+dn+uemail+uname2) "Register"为字符串常量,表示接口名称。 其他没有引号表示为POST参数变量,password为会员专区中设置的API认证密码 client为客户号,dn为域名,uemail为注册人电子邮件,uname2为注册单位英文名称 返回结果: ret 注册结果,0 失败,100成功 50 超时等待 info 正常的信息,1个 err 错误的信息,0-N个 返回信息: 格式: 操作/对象-结果 reg-success 注册成功 reg-waiting 提交成功,等待注册 reg-failure 注册失败 auth-failure 认证失败 name-null 域名为空 name-wrong 错误的域名后缀 name-invalid 域名无效包含错误字符 client-invalid 客户号无效 client-null 客户号为空 verify-null 没有摘要 db-fail 数据库连接失败 credit-fail 客户预付款不足 name-exist 域名已经存在 period-invalid 注册年限无效 verify-failure 摘要认证失败 uname1-invalid 注册人单位中文名称无效 uname1-null 注册人单位中文名称为空 uname2-invalid 注册人单位英文名称无效 uname2-null 注册人单位英文名称为空 uname3-invalid 注册人单位拼音无效 uname3-null 注册人单位拼音为空 uname4-invalid 注册人单位缩写无效 uname4-null 注册人单位缩写为空 rname1-invalid 注册人中文姓名无效 rname1-null 注册人中文姓名为空 rname2-invalid 注册人英文姓名无效 rname2-null 注册人英文姓名为空 uaddr1-invalid 注册人单位中文地址中文名称无效 uaddr1-null 注册人单位中文地址中文名称为空 uaddr2-invalid 注册人单位中文地址英文名称无效 uaddr2-null 注册人单位中文地址英文名称为空 ucity1-invalid 注册人单位中文城市无效 ucity1-null 注册人单位中文城市为空 ucity2-invalid 注册人单位英文城市无效 ucity2-null 注册人单位英文城市为空 uteln-invalid 注册人电话号码无效 uteln-null 注册人电话号码为空 ufaxn-invalid 注册人传真号码无效 ufaxn-null 注册人传真号码为空 uzip-invalid 注册人邮政编码无效 uzip-null 注册人邮政编码为空 moneytmp-err 亏损 例如: ret=100&info=reg-success ret=0&err=auth-failure ret=0&err=uname2-invalid&err=aemail-null&err=uaddr2-invalid&err=... 3.3 Status 接口 POST 地址: https://api.wvidc.com/domain/api.gb?method=Status dn 域名;1个,包括名字和后缀 enc 编码,E,G;1个;如果不填,默认为E client 会员名;1个 例如:dn=abc.com&enc=E&client=agent111 POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 返回结果: ret 返回结果,100注册成功,0注册不成功,50等待注册,-100该域名不存在 -20域名存在但您没有管理权限 err 错误信息 信息编码: auth-failure 认证失败 name-invalid 无效的域名 例如:ret=0&err=auth-failure 3.4 ModDns 接口 POST 地址: https://api.wvidc.com/domain/api.gb?method=ModDns POST 参数: [域名信息] dn 域名;1个,包括名字和后缀 enc 编码,E,G;1个; client 会员名;1个 dns1 域名主服务器名字[如果不填系统默认分配] dns2 域名辅服务器名字[如果不填系统默认分配] checksum MD5加密摘要
例如:dn=abc.com&enc=E&client=agent111&dns=ns1.wvidc.net.... POST 数据,都必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312),否则中文信息将不正确 验证:client和POST的来源IP必须与该会员填写的IP地址一致 checksum=MD5("ModDns"+client+password+dn+dns1+dns2) "ModDns"为字符串常量,表示接口名称。 其他没有引号表示为POST参数变量,password为会员专区中设置的API认证密码 client为客户号,dn为域名,dns1,dns2为域名服务器名字[例如:ns1.wvidc.net] 返回结果: ret 注册结果,0 失败,100成功 info 正常的信息,1个 err 错误的信息,0-N个 返回信息: 格式: 操作/对象-结果 mod-success 修改成功 mod-failure 修改失败 auth-failure 认证失败 name-null 域名为空 name-wrong 错误的域名后缀 name-invalid 域名无效包含错误字符 client-invalid 客户号无效 client-null 客户号为空 verify-null 没有摘要 db-fail 数据库连接失败 verify-failure 摘要认证失败 dns1-invalid 主域名服务器名字无效 dns1-null 主域名服务器名字为空 dns2-invalid 辅域名服务器名字无效 dns2-null 辅域名服务器名字为空 domain-auth-Failed 域名不是该会员所有 例如: ret=100&info=mod-success ret=0&err=auth-failure 3.5 domain续费接口 POST 地址: https://api.wvidc.com/domain/api.gb?method=DomainRenew 参数: client 会员名;1个 dn 域名;1个,包括名字和后缀 enc 编码,E,G;1个; begindate 续费起始日期 yyyy-mm-dd (起始日期是指域名当前到期时间) period 续费年数 不能大于9或等于0 checksum MD5校验码 moneytmp 选填,用户续费价,当价格低于自己的代理价时,续费会失败,防止亏损。
例如:checksum=b47746405dd4e41303e2ee1307155452&client=username&dn=ceshiceshi1.com.cn&enc=E&begindate=2005-10-07&period=1 POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 checksum=MD5("DomainRenew"+client+password+dn+enc+begindate) "DomainRenew"为字符串常量,表示接口名称。 其他没有引号表示为POST参数变量,password为会员专区中设置的API认证密码 client为客户号,dn为域名,enc为编码,begindate为续费起始日期 yyyy-mm-dd 返回结果: ret 注册结果,0 失败,100成功 info 正常的信息,1个 err 错误的信息,0-N个 返回信息: 格式: 操作/对象-结果 auth-failure 认证失败 client-null 客户号为空 verify-null 没有摘要 db-fail 数据库连接失败 verify-failure 摘要认证失败 period-invalid 续费年数错误 renew-success 认证失败 name-invalid 无效的域名 name-wrong 无效的域名 name-noexist 没有符合条件的域名 begindate-null 起始日期空 credit-fail 余额不足 clintId-error 没有域名的管理权限 date-error 起始日期或编码错误 db-error 数据库操作失败 last-waiting 上次续费操作未完成 invalid-renew 续费超过最长期限 begindate-error 起始日期与库里域名到期时间不一致 domain-auth-Failed 域名不是该会员所有 moneytmp-err 亏损 例如: ret=100&info=renew-success ret=0&err=auth-failure 域名最长年限: 国际域名:10年; 国内英文域名:10年; 国内中文域名:10年; 普通通用网址:10年; 通用词:10年; 白金词:2年。 PS: 超出域名最长年限的续费将不成功。 3.6 获取产品密码接口 POST 地址: https://api.wvidc.com/domain/api.gb?method=GetProductKey name 域名;1个,包括后缀 enc 编码,E,G;1个; client 会员名;1个 keyname 查询属性名//空或'Password'为密码查询,'ExpireDate'为查询域名过期日期[New!!!] 'MyDnsPass'查询MyDns密码 checksum MD5加密摘要 checksum=MD5("GetProductKey"+client+password+dn+enc) password: 会员API密码 例如: enc=E&client=agent1&name=rabette.com&keyname=ExpireDate&checksum=9bc77f99554dsacd046beba7e42081b5 返回:&name=rabette.com&key=2008-02-24 enc=E&client=agent1&name=rabette.com&checksum=9bc77f99554dsacd046beba7e42081b5 或 enc=E&client=agent1&name=rabette.com&keyname=Password&checksum=9bc77f99554dsacd046beba7e42081b5 返回:&name=rabette.com&key=sdfee22dd POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 返回结果: ret 返回结果, key[] 密码 err 错误信息 信息编码: auth-failure 认证失败 name-invalid 无效的域名 db-failure 数据库错误 domain-auth-Failed 域名不是该会员所有 例如:ret=0&err=auth-failure ret=0&err=db-failure 数据库错误 name=abc.org&key=dafsadfas 3.7 修改产品密码接口 POST 地址: https://api.wvidc.com/domain/api.gb?method=ChangeProductKey dn 域名;1个,包括名字和后缀 enc 编码,E,G;1个; client 会员名;1个 checksum MD5加密摘要 checksum=MD5("ChangeProductKey"+client+password+dn+enc) password: 会员API密码 keyname 修改属性名//空或'Password'(6-15)为域名管理密码查询,'MyDnsPass'(6-20)查询MyDns密码newkey 新密码 oldkey 初始密码 例如:dn=abc.com&enc=E&client=agent111&checksum=xxxxx&newkey=xxx&oldkey=xxxxx POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 返回结果: ret 返回结果 0错误 100成功 err 错误信息 key[1--N] 密码1-N//修改成功的密码 ret=0&err=oldkey-null ret=0&err=newkey-null 信息编码: failkey[1--N] 密码1-N//修改失败的密码 auth-failure 认证失败 name-invalid 无效的域名 name-notexist 域名不存在或者域名不属于该会员 db-failure 数据库错误 password-invalid 新密码无效 oldkey-invalid 旧密码密码验证失败 keyname-invalid 属性名无效不能识别的 domain-auth-Failed 域名不是该会员所有 例如:ret=0&err=auth-failure 成功: ret=100&name=dfdaf.org&keyname=Password&key=xdsfd 失败: ret=0&name=dfdaf.org&keyname=MyDnsPass&key=xdsfd 3.8 ModifyContactor 接口 POST 地址: https://api.wvidc.com/domain/api.gb?method=ModifyContactor POST 参数: [域名信息] dn 域名;1个,包括名字和后缀 enc 编码,E,G;1个;如果不填,默认为E client 会员名;1个 checksum MD5加密摘要 [注册所有人或注册单位的信息] uname1 注册人中文单位名称[必须](可不送,修改忽略) uname2 注册人英文单位名称[必须](可不送,修改忽略) uname3 注册单位拼音[.中国\通用网址必须](可不送,修改忽略) uname4 注册单位缩写[.中国\通用网址必须](可不送,修改忽略) location 注册人单位所在地[注册.中国\通用网址必须] rname1 注册人|单位负责人中文名称[国内域名必须] rname2 注册人|单位负责人英文名称[国际域名必须] ust 注册人英文国家名称,两个字母[CN表示中国],接口自动翻译中文 uprov 注册人英文省份名称, 如:Beijing,接口自动翻译中文 ucity1 注册人中文城市名称[国内域名必须] ucity2 注册人英文城市名称[国际域名必须] uaddr1 注册人中文地址[国内域名必须] uaddr2 注册人英文地址[国际域名必须] uzip 注册人邮政编码[必须] utelc 注册人电话国家码,可以不填默认为86 utela 注册人电话区号,如果为手机可以不填 uteln 注册人电话号码 utele 注册人电话分机 ufaxc 注册人传真国家码,可以不填默认为86 ufaxa 注册人传真区号,如果为手机可以不填 ufaxn 注册人传真号码 ufaxe 注册人传真分机 uemail 注册人email地址 trade 注册人所在行业英文编码[如果不填,默认为商业S8] [域名管理联系人信息] 管理联系人单位地址信息和注册人信息一致,所以不用填写 aname1 管理联系人中文名称[国内域名必填] aname2 管理联系人英文名称[国际域名必填] atelc 管理联系人电话国家码,可以不填默认为86 atela 管理联系人电话区号,如果为手机可以不填 ateln 管理联系人电话号码 atele 管理联系人电话分机,可以不填 afaxc 管理联系人传真国家码,可以不填默认为86 afaxa 管理联系人传真区号,如果为手机可以不填 afaxn 管理联系人传真号码 afaxe 管理联系人传真分机,可以不填 aemail 管理联系人电子邮件地址[必须] 说明:管理联系人和注册人的电话和传真必须保证一份为填写完整的。 否则,如果管理联系人电话传真缺少,将使用注册人的电话传真 如果注册人电话传真缺少,将使用管理联系人的电话传真 如果注册人没有email地址,将使用管理联系人的email地址 [技术联系人信息] tname1 技术联系人中文名称[如果不填,默认为管理联系人] tname2 技术联系人英文名称[如果不填,默认为管理联系人] tunit1 技术联系人单位中文名称[如果不填,默认为管理联系人] tunit2 技术联系人单位英文名称[如果不填,默认为管理联系人] tst 技术联系人英文国家名称,两个字母[CN表示中国],[如果不填,默认为管理联系人] tprov 技术联系人英文省份名称, 如:Beijing,接口自动翻译中文,[如果不填,默认为管理联系人] tcity1 技术联系人中文城市名称[如果不填,默认为管理联系人] tcity2 技术联系人英文城市名称[如果不填,默认为管理联系人] taddr1 技术联系人中文地址[如果不填,默认为管理联系人] taddr2 技术联系人英文地址[如果不填,默认为管理联系人] tzip 技术联系人邮政编码[如果不填,默认为管理联系人] temail 技术联系人电子邮件地址[如果不填,默认为管理联系人] ttelc 技术联系人电话国家码[如果不填,默认为管理联系人] ttela 技术联系人电话区号[如果不填,默认为管理联系人] tteln 技术联系人电话号码[如果不填,默认为管理联系人] ttele 技术联系人电话分机[如果不填,默认为管理联系人] tfaxc 技术联系人传真国家码[如果不填,默认为管理联系人] tfaxa 技术联系人传真区号[如果不填,默认为管理联系人] tfaxn 技术联系人传真号码[如果不填,默认为管理联系人] tfaxe 技术联系人传真分机[如果不填,默认为管理联系人] [交费联系人信息] fname1 交费联系人中文名称[如果不填,默认为管理联系人] fname2 交费联系人英文名称[如果不填,默认为管理联系人] funit1 交费联系人单位中文名称[如果不填,默认为管理联系人] funit2 交费联系人单位英文名称[如果不填,默认为管理联系人] fst 交费联系人英文国家名称,两个字母[CN表示中国],[如果不填,默认为管理联系人] fprov 交费联系人英文省份名称, 如:Beijing,接口自动翻译中文,[如果不填,默认为管理联系人] fcity1 交费联系人中文城市名称[如果不填,默认为管理联系人] fcity2 交费联系人英文城市名称[如果不填,默认为管理联系人] faddr1 交费联系人中文地址[如果不填,默认为管理联系人] faddr2 交费联系人英文地址[如果不填,默认为管理联系人] fzip 交费联系人邮政编码[如果不填,默认为管理联系人] femail 交费联系人电子邮件地址[如果不填,默认为管理联系人] ftelc 交费联系人电话国家码[如果不填,默认为管理联系人] ftela 交费联系人电话区号[如果不填,默认为管理联系人] fteln 交费联系人电话号码[如果不填,默认为管理联系人] ftele 交费联系人电话分机[如果不填,默认为管理联系人] ffaxc 交费联系人传真国家码[如果不填,默认为管理联系人] ffaxa 交费联系人传真区号[如果不填,默认为管理联系人] ffaxn 交费联系人传真号码[如果不填,默认为管理联系人] ffaxe 交费联系人传真分机[如果不填,默认为管理联系人] 例如:enc=G&client=username&dn=wvidc.com&checksum=36d1823da539765a66e408f670353ea6.... POST 数据,都必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312),否则中文信息将不正确 验证:client和POST的来源IP必须与该会员填写的IP地址一致 checksum=MD5(client+password+dn+uemail+aemail) 其他没有引号表示为POST参数变量,password为会员设置的API认证密码 client为客户号,dn为域名,aemail为管理联系人电子邮件,uemail注册联系人邮箱 返回结果: ret 注册结果,0 失败,100成功 50 超时等待 info 正常的信息,1个 err 错误的信息,0-N个 返回信息: 格式: 操作/对象-结果 modctr-sucess 操作成功 name-notexist 域名不存在 domain-auth-Failed 域名不是该会员所有 例如: ret=100&info=modctr-sucess ret=0&err=auth-failure ret=0&err=name-notexist ret=0&err=uname2-invalid&err=aemail-null&err=uaddr2-invalid&err=... 3.9 注册本域名下的DNS POST 地址: https://api.wvidc.com/domain/api.gb?method=AddSelfDNS dn 域名;1个,包括名字和后缀 ns DNS名称,如ns1.Wvidc.com中的ns1 ip IP地址 client 会员名;1个 checksum MD5加密摘要 checksum=MD5("AddSelfDNS"+client+password+dn+ns) password: 会员使用API的密码 例如:dn=abc.com&ds=ns1&ip=202.108.32.110&client=agent123&checksum=xxxxx POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 返回结果: ret 返回结果 0错误 100成功 err 错误信息 信息编码: auth-failure 认证失败 ns-invalid 无效的dns ns-null dns为空 name-null 域名为空 name-invalid 无效的域名 name-notexist 域名不存在或者域名不属于该会员 client-null 会员名为空 client-invalid 无效的会员名 checksum-null 加密摘要为空 ip-null IP为空 ip-invalid 无效的IP地址 db-failure 数据库错误 domain-auth-Failed 域名不是该会员所有 例如:ret=0&err=auth-failure 成功: ret=100&dn=abc.com&ns=ns1 失败: ret=0&dn=null&ns=null&client=null 3.10 查询本域名下的DNS POST 地址: https://api.wvidc.com/domain/api.gb?method=GetSelfDNS dn 域名;1个,包括名字和后缀 client 会员名;1个 checksum MD5加密摘要 checksum=MD5("GetSelfDNS"+client+password+dn) password: 会员使用API的密码 例如:dn=abc.com&client=agent123&checksum=xxxxx POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 返回结果: ret 返回结果 0错误 100成功 err 错误信息 信息编码: auth-failure 认证失败 name-null 域名为空 name-invalid 无效的域名 name-notexist 域名不存在或者域名不属于该会员 client-null 会员名为空 client-invalid 无效的会员名 checksum-null 加密摘要为空 domain-auth-Failed 域名不是该会员所有 例如:ret=0&err=auth-failure 成功: ret=100&dn=abc.com&ns1=ns1.abc.com&ip1=10.10.10.10&ns2=ns2.abc.com&ip2=20.20.20.20 失败: ret=0&dn=null&client=null 3.11 修改本域名下的DNS POST 地址: https://api.wvidc.com/domain/api.gb?method=ModSelfDNS dn 域名;1个,包括名字和后缀 ns DNS名称,如ns1.Wvidc.com中的ns1 ip IP地址 client 会员名;1个 checksum MD5加密摘要 checksum=MD5("ModSelfDNS"+client+password+dn+ns) password: 会员使用API的密码 例如:dn=abc.com&ns=ns1&ip=202.108.32.110&client=agent123&checksum=xxxxx POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 返回结果: ret 返回结果 0错误 100成功 err 错误信息 信息编码: auth-failure 认证失败 ns-invalid 无效的dns ns-null dns为空 name-null 域名为空 name-invalid 无效的域名 name-notexist 域名不存在或者域名不属于该会员 client-null 会员名为空 client-invalid 无效的会员名 checksum-null 加密摘要为空 ip-null IP为空 ip-invalid 无效的IP地址 domain-auth-Failed 域名不是该会员所有 例如:ret=0&err=auth-failure 成功: ret=100&dn=abc.com&ns=ns1.abc.com&ip=10.20.30.40 失败: ret=0&dn=null&client=null 3.12 删除本域名下的DNS POST 地址: https://api.wvidc.com/domain/api.gb?method=DelSelfDNS dn 域名;1个,包括名字和后缀 ns DNS名称,如ns1.wvidc.com中的ns1 client 会员名;1个 checksum MD5加密摘要 checksum=MD5("AddSelfDNS"+client+password+dn+ns) password: 会员使用API的密码 例如:dn=abc.com&ns=ns1&client=agent123&checksum=xxxxx POST 数据,必须进行URL编码(空格编码成+号,中文及特殊符号参数值进行UrlDecode编码GB2312) 验证:client和POST的来源IP必须与该会员填写的IP地址一致 返回结果: ret 返回结果 0错误 100成功 err 错误信息 信息编码: auth-failure 认证失败 ns-invalid 无效的dns ns-null dns为空 name-null 域名为空 name-invalid 无效的域名 name-notexist 域名不存在或者域名不属于该会员 client-null 会员名为空 client-invalid 无效的会员名 checksum-null 加密摘要为空 domain-auth-Failed 域名不是该会员所有 例如:ret=0&err=auth-failure 成功:ret=100&dn=abc.com&ns1=ns1 失败: ret=0&dn=null&client=null 3.13 解析记录查询接口: POST 地址: https://api.wvidc.com/domain/api.gb?method=DomainDNSQuery 描述:按照格式提供的域名和记录类型,返回当前域名在DNS库中对应的记录; 参数说明: name:域名; type:解析记录的类型; 发送信息格式: 查询NS记录:name=abc.com&type=NS 返回信息参数说明: ret:返回值(100代表成功,110代表没有符合条件的记录); num:记录数量; name:域名; client 会员名;1个 checksum MD5加密摘要 checksum=MD5("DomainDNSQuery"+client+password+name) password: 会员使用API的密码 recordnamen:记录名;(其中“n”代表第多少条记录,n>=1,以下意义均同此!); type:域名解析记录类型(参数值为“prime-records”表示需要在domains表中添加初始解析记录,ns,a,cname,mx,txt,url); contentn:解析内容 ttln:生存时间; prion:优先级; reason:错误信息(操作成功则不会发送此参数!); domain-auth-Failed 域名不是该会员所有 返回格式(参数前后顺序可以随意): 有记录的:ret=100&num=2&name=abc.com&type=NS&recordname1=abc.com&recordname2=abc.com&content1=ns1.wvidc.net&content2=ns.wvidc.cn&ttl1=3600&ttl2=3600 没有记录的:ret=100&num=0&name=abc.com 3.14 解析记录添加接口: POST 地址: https://api.wvidc.com/domain/api.gb?method=DomainDNSAdd 描述:按照给定内容和格式,添加域名相关的解析记录;需要先判定提供的域名是否已经在domains表中存在对应记录,否则,执行最初始的添加解析记录操作。 参数说明: name:域名; recordname:记录名; type:域名解析记录类型(参数值为“prime-records”表示需要在domains表中添加初始解析记录,ns,a,cname,mx,txt,url); content:解析内容; ttl:生存时间; prio:优先级(默认为“0”); client 会员名;1个 checksum MD5加密摘要 checksum=MD5("DomainDNSAdd"+client+password+name) password: 会员使用API的密码 发送信息格式: 添加最初记录:name=abc.com&type=prime-records 添加NS记录(默认优先级设置):name=abc.com&recordname=abc.com&type=NS&content=ns.Wvidc.cn&ttl=3600&prio=0 添加A记录(默认优先级设置):name=abc.com&recordname=www.abc.com&type=A&content=199.198.197.196&ttl=3600&prio=0 添加MX纪录(设定优先级):name=abc.com&recordname=mail.abc.com&type=MX&content=mail.Wvidc.com&ttl=3600&prio=5 返回信息参数说明: ret:返回值(100执行成功;120已有此记录;130参数内容有错误;140添加记录失败); reason:错误信息(操作成功则不会发送此参数!); domain-auth-Failed 域名不是该会员所有 返回格式: 添加成功:ret=100 添加失败:ret=120&reason=已有此记录 3.15 解析记录修改接口: POST 地址: https://api.wvidc.com/domain/api.gb?method=DomainDNSMod 描述:按照给定信息内容,修改对应的解析记录; 参数说明: name:域名; recordname:记录名; type:域名解析记录类型(参数值为“prime-records”表示需要在domains表中添加初始解析记录,ns,a,cname,mx,txt,url); content:新的解析内容; oldcontent:原有解析内容; ttl:生存时间; prio:优先级(可选择不提供此参数,默认为空); client 会员名;1个 checksum MD5加密摘要 checksum=MD5("DomainDNSMod"+client+password+name) password: 会员使用API的密码 发送信息格式: 修改NS记录(无优先级设置):name=abc.com& recordname=abc.com&type=NS&content=ns.Wvidc.cn &oldcontent=ns1.Wvidcdns.com&ttl=3600 说明: 格式1表明的是将原有纪录内容ns1.Wvidcdns.com更新为ns.Wvidc.cn 修改A记录(有优先级设置):name=abc.com&recordname=www.abc.com&type=A&content=199.198.197.196&oldcontent=123.0.0.1&ttl=3600&prio=5 说明: 格式2表明要将原有的IP地址123.0.0.1更改为新IP地址199.198.197.196 返回信息参数说明: ret:返回值(100执行成功;125此记录不存在;130参数内容有错误;160修改记录失败); reason:错误信息(操作成功则不会发送此参数!); domain-auth-Failed 域名不是该会员所有 返回格式: 添加成功:ret=100 添加失败:ret=130&reason=参数内容 3.16 解析记录删除接口: POST 地址: https://api.wvidc.com/domain/api.gb?method=DomainDNSDel 描述:按照给定信息内容,删除对应的解析记录。 参数描述: name:域名; recordname:记录名; content:解析纪录内容; type:域名解析记录类型(参数值为“prime-records”表示需要在domains表中添加初始解析记录,ns,a,cname,mx,txt,url); client 会员名;1个 checksum MD5加密摘要 checksum=MD5("DomainDNSDel"+client+password+name) password: 会员使用API的密码 发送信息格式: 删除全部类型的解析记录: name=abc.com&type=all-records 删除A记录: name=abc.com&recordname=www.abc.com&type=A&content=123.0.0.1 删除单个NS纪录: Name=abc.com&recordname=abc.com&type=NS&content=ns1.Wvidc.cn 返回信息参数说明: ret:返回值(100执行成功;125此记录不存在;130参数内容有错误;160删除记录失败); reason:错误信息(操作成功则不会发送此参数!); domain-auth-Failed 域名不是该会员所有 返回格式: 添加成功:ret=100 添加失败:ret=160&reason=删除记录失败 * 特别提醒:注册域名需阅读并同意《国际域名在线注册服务条款》根据ICANN和域名注册管理机构的相关规定,如果因为您的域名信息不真实、不准确、不完整,或者您利用域名进行发送垃圾邮件等不正当行为,您的域名将被删除或关闭!
打印
|