新网域名接口实例 - 【新格通达】

xgnic 实名认证

新网域名API接口文档POST参数注意事项：
1、所有电话号码及邮编必须为数字，且不能为零。
2、所有英文信息字段必须为英文。
3、本接口暂时不支持信任制代理。
1. 文档说明
1.1 文档简介： 本版本采用HTTP+POST方式进行注册。
1.2 使用限制
1、 只有新网的正式代理才能使用。
2、必须符合接口认证方式才能提交命令。
3、 注册接口按照该代理的价格进行实时注册实时扣费，如果预付款不足，将不能提交注册申请。
4、接口文档的获得和传播必须符合新网的保密协议
1.3 操作说明
1、代理在新网代理专区填写授权POST的IP地址和认证密码。
2、按照接口说明编写客户端程序向接口提交查询、注册命令，立刻获得结果。
1.4 md5串测试地址：
http://api.xinnet.com/domain/api.gb?method=testmd5
http://api.xinnet.com/domain/api.gb?method=testmd5&charset=utf-8 (utf-8字符集)
参数：strbuf      输出：strbuf内容及编码后的md5串
中文编码使用gb2312 或者utf-8编码，否则易出现md5校验错误verify-failure或 摘要认证失败。
注意：请确保相关程序文件的charset设置和文件自身保存的编码一致。并请保证所有关联文件编码一致，您明确要求不一致（需转码）的除外。gb2312和utf-8中文md5结果可能不同，请确保提交内容字符集和md5串一致。
2. 接口概述
2.1 接口目录
Check接口：主要负责进行域名的查询，采用多线程方式，可以同时查询多个域名
Register接口：注册接口，实时注册，成功后立即扣费。如果超时，不转为后台注册，域名将被删除。
Status接口：查询域名是否注册成功。
ModDns接口：进行在线修改DNS操作。
DomainRenew接口：域名续费接口，实时续费，立即扣费。
GetProductKey接口：获取域名管理密码、mydns密码以及域名到期时间。
ChangeProductKey接口：修改域名管理密码以及mydns密码。
ModifyContactor接口：修改除域名所有人以外的所有联系人信息。
AddSelfDNS接口：注册本域名下的DNS。GetSelfDNS接口：查询本域名下的DNS。
DomainDNSQuery接口：修改本域名下的DNS。DelSelfDNS接口：删除本域名下的DNS。
最新还支持：解析记录查询、添加、修改和删除，因为对大部分代理商没有用，因此不研究。
2.2 认证方式
1、IP限制，对于任何接口必须从该代理授权的IP，每个代理限填3个IP地址。
2、MD5非可逆加密摘要，除Check接口、和Status接口外，其它所有接口都要求提供。
2.3 返回结果：按照POST数据格式返回数据结果
3. 接口说明
3.1 Check 接口
POST 地址: http://api.xinnet.com/domain/api.gb?method=check
POST 参数:
name 名字，1个，没有后缀
enc  编码，E/G，1个
suffix 后缀，可以多个，域名后缀.com/.net/.org/.中国/.cn等
client 代理号，1个
例如：name=abc&enc=E&suffix=.com&suffix=.net&suffix=.cn&client=agent111（POST 数据必须进行URL编码）
返回结果:
num 域名数量
enc 编码
name[1--N] 域名+后缀 N为连续数据
chk[1--N] 查询结果，0 -不可注册 100-可以注册
信息编码 auth-failure 认证失败
例如：num=3&enc=E&name1=abc.com&chk1=0&name2=abc.net&chk2=100&name3=abc.org&chk3=-100
3.2  Register 接口
POST 地址: http://api.xinnet.com/domain/api.gb?method=Register
POST 参数:
[域名信息]
dn        域名，1个，包括名字和后缀
enc       编码，E/G，1个
client    代理号，1个
checksum  MD5加密摘要
period    注册年数[如果不填默认为1年]，有效值1-10年
[注册所有人或注册单位的信息]
uname1 注册人中文单位名称
uname2 注册人英文单位名称            必须英文，且中间有一个空格
uname3 注册单位拼音                     [.中国必须]
uname4 注册单位缩写                     [.中国必须]
location 注册人单位所在地                [.中国必须]
rname1 注册人|单位负责人中文名称
rname2 注册人|单位负责人英文名称
ust    注册人英文国家名称                 两个字母[CN表示中国]，接口自动翻译中文
uprov  注册人英文省份名称                 如：Beijing，接口自动翻译中文
ucity1 注册人中文城市名称
ucity2 注册人英文城市名称
uaddr1 注册人中文地址
uaddr2 注册人英文地址
uzip   注册人邮政编码
utelc  注册人电话国家码                可以不填默认为86，长度不能大于3位
utela  注册人电话区号                    如果为手机可以不填，此项不可为0
uteln  注册人电话号码                   区号+电话号码长度必须小于12
ufaxc  注册人传真国家码
ufaxa  注册人传真区号
ufaxn  注册人传真号码
uemail 注册人email地址
[asia域名要加3个字段]
entitytype 域名所有人类型
可选： naturalPerson   个人  corporation     公司或社团法人  cooperative     合作社  partnership    合伙或集体公司    government      政府机关 politicalParty  政党或工会   society    信托管理机构﹑资产管理机构﹑协会或社团    institution     公共机构    other    其他
certtype  域名证件类型
可选：passport   护照或居民身份证   certificate   营业执照   legislation   特许成立的法定机构证明   societiesRegistry    非营利团体登记证明 politicalPartyRegistry  政党注册证明   other    其他
certcode  域名证件号码
[域名管理联系人信息]
aname1 管理联系人中文名称                [国内域名必填]
aname2 管理联系人英文名称                [国际域名必填]
atelc  管理联系人电话国家码                可以不填默认为86，长度不能大于3位
atela  管理联系人电话区号                如果为手机可以不填
ateln  管理联系人电话号码                区号+电话号码长度必须小于12
afaxc  管理联系人传真国家码
afaxa  管理联系人传真区号
afaxn  管理联系人传真号码
aemail 管理联系人电子邮件地址                [必须]
说明：管理联系人和注册人的电话和传真必须保证一份为填写完整的。否则，如果管理联系人电话传真缺少，将使用注册人的电话传真；如果注册人电话传真缺少，将使用管理联系人的电话传真；如果注册人没有email地址，将使用管理联系人的email地址。
[DNS信息]
dns1  域名主服务器名字                    [如果不填默认为ns.xinnetdns.com]
dns2  域名辅服务器名字                    [如果不填默认为ns.xinnet.cn]
例如：dn=abc.com&enc=E&client=agent111&period=1....（POST 数据都必须进行URL编码，否则中文信息将不正确）
checksum=MD5("Register"+client+password+dn+aemail+uname2)  "Register"为字符串常量，表示接口名称。
返回结果:
ret 注册结果，0-失败，100-成功  50-超时等待
info 正常的信息，1个
err 错误的信息，可以多个
返回信息:
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       注册人邮政编码为空
aname1-invalid  管理联系人中文姓名无效
aname1-null     管理联系人中文姓名为空
aname2-invalid  管理联系人英文姓名无效
aname2-null     管理联系人英文姓名为空
ateln-invalid   管理联系人电话号码无效
ateln-null      管理联系人电话号码为空
afaxn-invalid   管理联系人传真号码无效
afaxn-null      管理联系人传真号码为空
aemail-invalid  管理联系人email无效
aemail-null     管理联系人email为空
uincode-invalid travel域名UIN编码无效
certtype-invalid asia域名证件类型无效
certcode-invalid asia 域名证件号码无效
entitytype-invalid asia域名实体类型无效
例如: 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 地址: http://api.xinnet.com/domain/api.gb?method=Status
POST 参数:
dn        域名，1个，包括名字和后缀
enc       编码，E/G，1个
client    代理号，1个
例如：dn=abc.com&enc=E&client=agent111（POST 数据，必须进行URL编码）
返回结果:
ret  返回结果，100-注册成功，0-注册不成功，50-等待注册，-100-域名不存在，-20-域名存在但没有管理权限
err  错误信息
信息编码:auth-failure 认证失败，name-invalid 无效的域名
例如：ret=0&err=auth-failure
3.4  ModDns 接口
POST 地址: http://api.xinnet.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&dns1=ns.xinnetdns.com&dns2=ns.xinnetdns2.com....（POST 数据都必须进行URL编码，否则中文信息将不正确）
checksum=MD5("ModDns"+client+password+dn+dns1+dns2) "ModDns"为字符串常量，表示接口名称。其他没有引号表示为POST参数变量,password为代理专区中设置的认证密码，client为客户号，dn为域名，dns1/dns2为域名服务器。
返回结果:
ret 注册结果，0- 失败，100-成功
info 正常的信息，1个
err 错误的信息，可以多个
返回信息:  （格式: 操作/对象-结果）
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 DomainRnew接口
POST 地址: http://api.xinnet.com/domain/api.gb?method=DomainRenew
POST 参数:
dn        域名，1个，包括名字和后缀
enc       编码，E/G，1个
client    代理号，1个
begindate    域名当前到期时间 yyyy-mm-dd
period        续费年数，不能大于9或等于0
checksum    MD5校验码
例如：client=agent4978&dn=ceshi.com.cn&enc=E&begindate=2005-10-07&period=1（POST 数据，必须进行URL编码）
checksum=MD5("DomainRenew"+client+password+dn+enc+begindate)     "DomainRenew"为字符串常量，表示接口名称。
其他没有引号表示为POST参数变量,password为代理专区中设置的认证密码，client为客户号，dn为域名，enc为编码。
返回结果:
ret 注册结果，0-失败，100-成功
info 正常的信息，1个
err 错误的信息，可以多个
返回信息:  （格式: 操作/对象-结果）
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 域名不是该代理所有
例如: ret=100&info=renew-success
ret=0&err=auth-failure
PS： 超出域名最长年限的续费将不成功。
3.6    获取产品密码接口（查询域名过期日期）
POST 地址: http://api.xinnet.com/domain/api.gb?method=GetProductKey
POST 参数:
name        域名，1个，包括名字和后缀
enc       编码，E/G，1个
client    代理号，1个
keyname   查询属性名。为空或'Password'为密码查询，'ExpireDate'为查询域名过期日期，'MyDnsPass'查询MyDns密码
checksum=MD5("GetProductKey"+client+password+dn+enc)
例如：enc=E&client=agent1&name=rabette.com&keyname=ExpireDate&checksum=111
返回：&name=rabette.com&key=2008-02-24
或者：enc=E&client=agent1&name=rabette.com&keyname=Password&checksum=111
返回：&name=rabette.com&key=sdfee22dd
返回结果:
ret  返回结果，0-失败
err  错误信息
key 域名密码或到期时间
信息编码:
auth-failure 认证失败
name-invalid 无效的域名
db-failure 数据库错误
domain-auth-Failed 域名不是该代理所有
例如：ret=0&err=auth-failure
ret=0&err=db-failure
3.7 修改产品密码接口
POST 地址: http://api.xinnet.com/domain/api.gb?method=ChangeProductKey
POST 参数:
dn        域名，1个，包括名字和后缀
enc       编码，E/G，1个
client    代理号，1个
checksum=MD5("ChangeProductKey"+client+password+dn+enc)
keyname   修改属性名。为空或'Password'（6-15）为域名管理密码查询，'MyDnsPass'（6-20）修改MyDns密码
newkey    新密码
oldkey    初始密码
例如：dn=abc.com&enc=E&client=agent111&checksum=xxxxx&newkey=xxx&oldkey=xxxxx
返回结果:
ret  返回结果 0-错误 100-成功
err  错误信息
key[1-N] 密码1-N//修改成功的密码
ret=0&oldkey=null
ret=0&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 地址: http://api.xinnet.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地址
[管理联系人信息]
aname1 管理联系人中文名称
aname2 管理联系人英文名称
atelc  管理联系人电话国家码
atela  管理联系人电话区号
ateln  管理联系人电话号码
atele  管理联系人电话分机
afaxc  管理联系人传真国家码
afaxa  管理联系人传真区号
afaxn  管理联系人传真号码
afaxe  管理联系人传真分机
aemail 管理联系人电子邮件地址
说明：管理联系人和注册人的电话和传真必须保证一份为填写完整的。否则，如果管理联系人电话传真缺少，将使用注册人的电话传真；如果注册人电话传真缺少，将使用管理联系人的电话传真。如果注册人没有email地址，将使用管理联系人的email地址。
例如：enc=G&client=agent4978&dn=xinnet.com&checksum=36d1823da539....
checksum=MD5(client+password+dn+uemail+aemail) 其他没有引号表示为POST参数变量，password为代理专区中设置的认证密码，client为客户号，dn为域名，aemail为管理联系人电子邮件，uemail注册联系人邮箱。
返回结果:
ret 注册结果，0-失败，100-成功  50-超时等待
info 正常的信息，1个
err 错误的信息，可以多个
返回信息:  （格式: 操作/对象-结果）
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=...