新网域名查询和注册API接口类 源码

简介:

最近公司要做一个基于新网的API,在自己的系统中实现实时查询域名注册情况,并且要能实时注册,注册费用自动从我们的代理帐户中扣除,下面是我写的核心实现类代码:
     public   class  XinNetApiBase
    {
        
// 默认代理编号
         public   readonly   static   string  AgentID  =   " agent88888 " ;

        
private  Encoding _WebEncode  =  Encoding.GetEncoding( " UTF-8 " );
        
private   string  _RequestString;
        
private   string  _Result;
        
private   string  _RequestUrl;
        
private  WebClient _EWebClient  =   new  WebClient();

        
///   <summary>
        
///  处理编码
        
///   </summary>
         public  Encoding WebEncode
        {
            
get  {  return  _WebEncode; }
            
set  { _WebEncode  =  value; }
        }

        
///   <summary>
        
///  请求的查询参数
        
///   </summary>
         public   string  RequestString
        {
            
get  {  return  _RequestString; }
            
set  { _RequestString  =  value; }
        }


        
///   <summary>
        
///  请求返回的结果
        
///   </summary>
         public   string  Result
        {
            
get  {  return  _Result; }
            
set  { _Result  =  value; }
        }

        
///   <summary>
        
///  请求的URL地址
        
///   </summary>
         public   string  RequestUrl
        {
            
get  {  return  _RequestUrl; }
            
set  { _RequestUrl  =  value; }
        }

        
///   <summary>
        
///  客户端与服务器通信类
        
///   </summary>
         public  WebClient EWebClient
        {
            
get  {  return  _EWebClient; }
            
set  { _EWebClient  =  value; }
        }

        
public  XinNetApiBase(ApiType _apitype, List < QueryParam >  _list)
        {
            
this .RequestUrl  =  GetApiUrl(_apitype);
            
this .RequestString  =  GetRequestString(_list);
            
this .GetHttp();
        }

        
public  XinNetApiBase( string  _ApiUrl, List < QueryParam >  _list)
        {
            
this .RequestUrl  =  _ApiUrl;
            
this .RequestString  =  GetRequestString(_list);
        }

        
public   string  GetRequestString(List < QueryParam >  list)
        {
            
string  requestUrl  =   "" ;
            
foreach  (QueryParam q  in  list)
            {
                requestUrl 
+=  q.QueryName  +   " = "   +  HttpUtility.UrlEncode(q.QueryValue,  this .WebEncode)  +   " & " ;
            }
            
return  requestUrl.TrimEnd( ' & ' );
        }

        
public   string  GetHttp()
        {

            
this .EWebClient.Headers.Add(HttpRequestHeader.ContentType,  " application/x-www-form-urlencoded " );
            
this .EWebClient.Encoding  =   this .WebEncode;
            
this .Result  =   this .EWebClient.UploadString( new  Uri( this .RequestUrl),  " POST " this .RequestString);

            
return   this .Result;

        }

        
public   string  GetApiUrl(ApiType _ApiType)
        {
            
string  _Url  =   "" ;
            
switch  (_ApiType)
            {
                
case  ApiType.Check:
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=check&charset=utf-8 " ;
                    
break ;
                
case  ApiType.Register:
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=Register&charset=utf-8 " ;
                    
break ;
                
case  ApiType.Status:
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=Status&charset=utf-8 " ;
                    
break ;
                
case  ApiType.ModDns:
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=ModDns&charset=utf-8 " ;
                    
break ;
                
case  ApiType.domain:
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=DomainRenew&charset=utf-8 " ;
                    
break ;
                
case  ApiType.GetProductKey:
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=GetProductKey&charset=utf-8 " ;
                    
break ;
                
case  ApiType.ChangeProductKey:
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=ChangeProductKey&charset=utf-8 " ;
                    
break ;
                
case  ApiType.ModifyContactor:
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=ModifyContactor&charset=utf-8 " ;
                    
break ;
                
default :
                    _Url 
=   " http://api.xinnet.com/domain/api.gb?method=testmd5&charset=utf-8 " ;
                    
break ;
            }

            
return  _Url;
        }

        
///   <summary>
        
///  MD5加密
        
///   </summary>
        
///   <param name="_ConvertString"> 加密的内容 </param>
        
///   <param name="_Len"> 16或32 表示16位或32位 </param>
        
///   <returns></returns>
         public   static   string  MD5( string  _ConvertString,  int  _Len)
        {
            
using  (System.Security.Cryptography.MD5CryptoServiceProvider provider  =   new  System.Security.Cryptography.MD5CryptoServiceProvider())
            {
                
switch  (_Len)
                {
                    
case   16 :
                        
return  BitConverter.ToString(provider.ComputeHash(Encoding.UTF8.GetBytes(_ConvertString)),  4 8 ).Replace( " - " string .Empty).ToUpper(System.Globalization.CultureInfo.CurrentCulture);

                    
case   32 :
                        
return  BitConverter.ToString(provider.ComputeHash(Encoding.UTF8.GetBytes(_ConvertString))).Replace( " - " string .Empty).ToUpper(System.Globalization.CultureInfo.CurrentCulture);
                    
default :
                        
return  BitConverter.ToString(provider.ComputeHash(Encoding.UTF8.GetBytes(_ConvertString))).Replace( " - " string .Empty).ToUpper(System.Globalization.CultureInfo.CurrentCulture);

                }
            }
        }

    }

    
public   class  QueryParam
    {
        
private   string  _QueryName;
        
private   string  _QueryValue;

        
public   string  QueryName
        {
            
set  {  this ._QueryName  =  value; }
            
get  {  return   this ._QueryName; }
        }

        
public   string  QueryValue
        {
            
set  {  this ._QueryValue  =  value; }
            
get  {  return   this ._QueryValue; }
        }

        
public  QueryParam( string  _Name,  string  _Value)
        {
            
this .QueryName  =  _Name;
            
this .QueryValue  =  _Value;
        }

    }

    
public   enum  ApiType
    {
        Check,
        Register,
        Status,
        ModDns,
        domain,
        GetProductKey,
        ChangeProductKey,
        ModifyContactor
    }

查询域名是否已经注册,使用演示:
            List < QueryParam >  param  =   new  List < QueryParam > ();

            param.Add(
new  QueryParam( " name " " viqiwu " ));
            param.Add(
new  QueryParam( " enc " " E " ));
            param.Add(
new  QueryParam( " suffix " " .com " ));
            param.Add(
new  QueryParam( " suffix " " .com.cn " ));
            param.Add(
new  QueryParam( " suffix " " .cn " ));
            param.Add(
new  QueryParam( " client " " agent88888 " ));

            XinNetApiBase _XinNet 
=   new  XinNetApiBase(ApiType.Check, param);

            Response.Write(_XinNet.Result);

            
// _XinNet.Result 返回的结果 num=3&enc=E&name1=viqiwu.com&chk1=0&name2=viqiwu.com.cn&chk2=100&name3=viqiwu.cn&chk3=0
            
// chk1=0 表示不能注册了  chk1=100 表示可以注册


下面是官方API说明文档:
Xinnet Corp.                           北京新网数码信息技术有限公司


POST参数注意事项:
    所有电话号码及邮编必须为数字,且不能为零
    所有英文信息字段必须为
    本接口暂时不支持信任制代理
1. 文档说明
   1.1 文档简介
    本版本采用HTTP+POST方式进行注册。
   1.2 使用限制
       只有新网的正式代理才能使用。
       必须符合接口认证方式才能提交命令。
       注册接口按照该代理的价格进行实时注册实时扣费,如果预付款不足,将不能提交注册申请。
       接口文档的获得和传播必须符合新网的保密协议
   1.3 操作说明
    1。代理在新网代理专区填写授权POST的IP地址和认证密码。
    2。按照接口说明编写客户端程序向接口提交查询、注册命令,立刻获得结果。
       
   1.4 域名范围
    国际域名,.com,.net,.org,.biz,.info,.cc,.mobi域名,包括中文.com,.cc
       国内域名,.cn,.com.cn类,.中国,.网络,.公司,通用网址
   1.5 md5串测试地址:
    url: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操作。
       domain续费接口:域名续费接口,实时续费,立即扣费。
       获取产品密码接口:获取域名管理密码、mydns密码以及域名到期时间。
       修改产品密码接口:修改域名管理密码以及mydns密码。
       ModifyContactor 接口:修改除域名所有人以外的所有联系人信息。
       注册本域名下的DNS:注册本域名下的DNS。
       查询本域名下的DNS:查询本域名下的DNS。
       修改本域名下的DNS:修改本域名下的DNS。
       删除本域名下的DNS:删除本域名下的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
          http://api.xinnet.com/domain/api.gb?method=check
&charset =utf-8    (utf-8字符集)
       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 =agent111
            POST 数据,必须进行URL编码
            验证:client和POST的来源IP必须与该代理填写的地址一致
       
       返回结果:   num 域名数量
                   enc 编码
                   name[1--N] 域名,名字+后缀 N=num
                   chk[1--N] N=num 查询结果: 0 不可注册 100 可以注册

       信息编码:
                      auth-failure 认证失败

       例如:num=3
&enc =E &name1 =abc.com &chk1 =0 &name2 =abc.net &chk2 =100 &name3 =abc.org &chk3 =-100
       注意:通用网址suffix=cnaddr(目前仅提供老通用网址续费,不提供注册服务)

   3.2  Register 接口
       POST 地址: http://api.xinnet.com/domain/api.gb?method=Register
          http://api.xinnet.com/domain/api.gb?method=Register
&charset =utf-8    (utf-8字符集)
       POST 参数: 
              [域名信息]
                dn        域名;1个,包括名字和后缀
                enc       编码,E,G;1个;
                client    代理号;1个
                checksum  MD5加密摘要
                period    注册年数;[如果不填默认为1年],有效值1-10年
                url       URL转发[通用网址需要,如果不填默认为www.xinnet.com]

              [注册所有人或注册单位的信息]

                uname1 注册人中文单位名称                [必须]
                uname2 注册人英文单位名称                [必须]------------------- 必须英文,且中间有一个空


                uname3 注册单位拼音                    [.中国\通用网址必须] ---------- 必须为字母
                uname4 注册单位缩写                    [.中国\通用网址必须] ---------- 
                location 注册人单位所在地                [注册.中国\通用网址必须]
                rname1 注册人|单位负责人中文名称            [国内域名必须]
                rname2 注册人|单位负责人英文名称            [国际域名必须]
                ust    注册人英文国家名称                 两个字母[CN表示中国],接口自动翻译中文
                uprov  注册人英文省份名称                 如:Beijing,接口自动翻译中文
                ucity1 注册人中文城市名称                [国内域名必须]
                ucity2 注册人英文城市名称                [国际域名必须]
                uaddr1 注册人中文地址                    [国内域名必须]
                uaddr2 注册人英文地址                    [国际域名必须]
                uzip   注册人邮政编码                    [必须]
                utelc  注册人电话国家码,                可以不填默认为86,长度不能大于3位
                utela  注册人电话区号                    如果为手机可以不填,此项不可为0
                uteln  注册人电话号码             (区号+电话号码长度必须小于12)
                utele  注册人电话分机
                ufaxc  注册人传真国家码,                可以不填默认为86,长度不能大于3位
                ufaxa  注册人传真区号                    如果为手机可以不填,此项不可为0
                ufaxn  注册人传真号码                    必须为数字 (区号+传真号码长度必须小于12)
                ufaxe  注册人传真分机
                uemail 注册人email地址
                trade  注册人所在行业英文编码                [如果不填,默认为商业S8]//此字段最好不填,如果

填写,千万不能用小写S
                [域名管理联系人信息]                    管理联系人单位地址信息和注册人信息一致,所以不用填


        uincode  travel域名UIN编码        travel域名必须,其他域名不需要
        certtype asia域名证件类型        asia域名必须,其他域名不需要
            passport                护照或居民身份证  
            certificate             营业执照  
            legislation             特许成立的法定机构证明  
            societiesRegistry       非营利团体登记证明  
            politicalPartyRegistry  政党注册证明 
            other                    其他
            
        certcode asia域名证件号码        asia域名必须,其他域名不需要
        entitytype asia域名实体类型        asia域名必须,其他域名不需要
            naturalPerson   个人  
            corporation     公司或社团法人  
            cooperative     合作社  
            partnership     合伙或集体公司  
            government      政府机关  
            politicalParty  政党或工会  
            society         信托管理机构﹑资产管理机构﹑协会或社团  
            institution     公共机构  
            other            其他
                aname1 管理联系人中文名称                [国内域名必填]
                aname2 管理联系人英文名称                [国际域名必填]
                atelc  管理联系人电话国家码                可以不填默认为86,长度不能大于3位
                atela  管理联系人电话区号                如果为手机可以不填
                ateln  管理联系人电话号码         区号+电话号码长度必须小于12
                atele  管理联系人电话分机                可以不填,此项不可为0
                afaxc  管理联系人传真国家码,可以不填默认为86,长度不能大于3位
                afaxa  管理联系人传真区号,如果为手机可以不填        可以不填,此项不可为0
                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  交费联系人传真分机                [如果不填,默认为管理联系人]
                [DNS信息]
                dns1  域名主服务器名字                    [如果不填默认为ns.xinnetdns.com]
                dns2  域名辅服务器名字                    [如果不填默认为ns.xinnet.cn]

             例如:dn=abc.com
&enc =E &client =agent111 &period =1.
             POST 数据,都必须进行URL编码,否则中文信息将不正确
       
             验证:client和POST的来源IP必须与该代理填写的地址一致
                  checksum=MD5("Register"+client+password+dn+aemail+uname2)
                  "Register"为字符串常量,表示接口名称。
                  其他没有引号表示为POST参数变量,password为代理专区中设置的认证密码
                  client为客户号,dn为域名,aemail为管理联系人电子邮件,unit2为注册单位英文名称

       返回结果:  ret 注册结果,0 失败,100成功  50 超时等待
                  info 正常的信息,1个
              err 错误的信息,0-N个
       返回信息:   
           格式: 操作/对象-结果
                      reg-success  注册成功
                      reg-waiting  提交成功,等待注册 
                      reg-failure  注册失败
                      reg-unauth 未被授权注册通用网址[new]
                      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     注册人单位英文城市为空
                      aname1-invalid  管理联系人中文姓名无效
                      aname1-null     管理联系人中文姓名为空
                      aname2-invalid  管理联系人英文姓名无效
                      aname2-null     管理联系人英文姓名为空
                      uteln-invalid   注册人电话号码无效
                      uteln-null      注册人电话号码为空
                      ateln-invalid   管理联系人电话号码无效
                      ateln-null      管理联系人电话号码为空
                      ufaxn-invalid   注册人传真号码无效
                      ufaxn-null      注册人传真号码为空
                      afaxn-invalid   管理联系人传真号码无效
                      afaxn-null      管理联系人传真号码为空
                      uzip-invalid    注册人邮政编码无效
                      uzip-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
          http://api.xinnet.com/domain/api.gb?method=Status
&charset =utf-8    (utf-8字符集)
                  dn        域名;1个,包括名字和后缀
                  enc       编码,E,G;1个;如果不填,模认为E
                  client    代理号;1个
            例如:dn=abc.com
&enc =E &client =agent111
            POST 数据,必须进行URL编码
            验证:client和POST的来源IP必须与该代理填写的地址一致
       
       返回结果:  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
          http://api.xinnet.com/domain/api.gb?method=ModDns
&charset =utf-8    (utf-8字符集)
       POST 参数: 
              [域名信息]
              dn        域名;1个,包括名字和后缀
                  enc       编码,E,G;1个;
                  client    代理号;1个
              dns1      域名主服务器名字[必须填写]
              dns2      域名辅服务器名字[必须填写]
          checksum  MD5加密摘要

        例如:dn=abc.com
&enc =E &client =agent111 &dns =ns.xinnetdns.com.
        POST 数据,都必须进行URL编码,否则中文信息将不正确
       
             验证:client和POST的来源IP必须与该代理填写的地址一致
                  checksum=MD5("ModDns"+client+password+dn+dns1+dns2)
                  "ModDns"为字符串常量,表示接口名称。
                  其他没有引号表示为POST参数变量,password为代理专区中设置的认证密码
                  client为客户号,dn为域名,dns1,dns2为域名服务器名字[例如:ns.xinnetdns.com]

       返回结果:  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 地址: http://api.xinnet.com/domain/api.gb?method=DomainRenew
           http://api.xinnet.com/domain/api.gb?method=DomainRenew
&charset =utf-8    (utf-8字符集)
        参数:
        client        代理号;1个
        dn        域名;1个,包括名字和后缀
        enc        编码,E,G;1个;
        begindate    续费起始日期 yyyy-mm-dd (起始日期是指域名当前到期时间)
        period        续费年数 不能大于9或等于0
        checksum    MD5校验码 
        例如:

checksum=b47746405dd4e41303e2ee1307155452
&client =agent4978 &dn =ceshiceshi1.com.cn &enc =E &begindate =2005-10-

07
&period =1
        POST 数据,必须进行URL编码
                验证:client和POST的来源IP必须与该代理填写的地址一致
                checksum=MD5("DomainRenew"+client+password+dn+enc+begindate)

                "DomainRenew"为字符串常量,表示接口名称。
                其他没有引号表示为POST参数变量,password为代理专区中设置的认证密码
                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 域名不是该代理所有

        例如:
                ret=100
&info =renew-success
                ret=0
&err =auth-failure
        域名最长年限:
        国际域名:10年;
        国内英文域名:10年;
        国内中文域名:10年;
        普通通用网址:10年;
        通用词:10年;
        白金词:2年。

PS:
    超出域名最长年限的续费将不成功。

3.6    获取产品密码接口
    POST 地址: http://api.xinnet.com/domain/api.gb?method=GetProductKey
           http://api.xinnet.com/domain/api.gb?method=GetProductKey
&charset =utf-8    (utf-8字符

集)
                name        域名;1个,包括后缀
              
                enc       编码,E,G;1个;
                client    代理号;1个
                keyname   查询属性名//空或'Password'为密码查询,'ExpireDate'为查询域名过期日期[New!!!] 
                    'MyDnsPass'查询MyDns密码
                checksum  MD5加密摘要
                    checksum=MD5("GetProductKey"+client+password+dn+enc) password: 代理密码
        例如:
                

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编码
        验证:client和POST的来源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 地址: http://api.xinnet.com/domain/api.gb?method=ChangeProductKey
          http://api.xinnet.com/domain/api.gb?method=ChangeProductKey
&charset =utf-8    (utf-8字符

集)
                  dn        域名;1个,包括名字和后缀
                  enc       编码,E,G;1个;
                  client    代理号;1个
                  checksum  MD5加密摘要
                        checksum=MD5("ChangeProductKey"+client+password+dn+enc)  password: 代理密码
                  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编码
        验证:client和POST的来源IP必须与该代理填写的地址一致
   
        返回结果:
                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
           http://api.xinnet.com/domain/api.gb?method=ModifyContactor
&charset =utf-8    (utf-8字符集)
    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 =agent4978 &dn =xinnet.com &checksum =36d1823da539765a66e408f670353ea6.
    POST 数据,都必须进行URL编码,否则中文信息将不正确

    验证:client和POST的来源IP必须与该代理填写的地址一致
        checksum=MD5(client+password+dn+uemail+aemail)
    
    其他没有引号表示为POST参数变量,password为代理专区中设置的认证密码
        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 地址: http://api.xinnet.com/domain/api.gb?method=AddSelfDNS
          http://api.xinnet.com/domain/api.gb?method=AddSelfDNS
&charset =utf-8    (utf-8字符集)
                  dn        域名;1个,包括名字和后缀
                  ns        DNS名称,如ns1.xinnet.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编码
        验证:client和POST的来源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 地址: http://api.xinnet.com/domain/api.gb?method=GetSelfDNS
          http://api.xinnet.com/domain/api.gb?method=GetSelfDNS
&charset =utf-8    (utf-8字符集)
                  dn        域名;1个,包括名字和后缀
                  client    代理号;1个
                  checksum  MD5加密摘要
                        checksum=MD5("GetSelfDNS"+client+password+dn)  password: 代理使用API的密码
              例如:dn=abc.com
&client =agent123 &checksum =xxxxx
    POST 数据,必须进行URL编码
        验证:client和POST的来源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 地址: http://api.xinnet.com/domain/api.gb?method=ModSelfDNS
          http://api.xinnet.com/domain/api.gb?method=ModSelfDNS
&charset =utf-8    (utf-8字符集)
                  dn        域名;1个,包括名字和后缀
          ns        DNS名称,如ns1.xinnet.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编码
        验证:client和POST的来源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 地址: http://api.xinnet.com/domain/api.gb?method=DelSelfDNS
          http://api.xinnet.com/domain/api.gb?method=DelSelfDNS
&charset =utf-8    (utf-8字符集)
                  dn        域名;1个,包括名字和后缀
          ns        DNS名称,如ns1.xinnet.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编码
        验证:client和POST的来源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 地址: http://api.xinnet.com/domain/api.gb?method=DomainDNSQuery
           http://api.xinnet.com/domain/api.gb?method=DomainDNSQuery
&charset =utf-8    (utf-8字符

集)
    描述:按照格式提供的域名和记录类型,返回当前域名在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 =ns.xinnetdns.com &conten

t2=ns.xinnet.cn
&ttl1 =3600 &ttl2 =3600
    没有记录的:ret=110
&reason =没有符合条件的记录

3.14 解析记录添加接口:
    POST 地址: http://api.xinnet.com/domain/api.gb?method=DomainDNSAdd
           http://api.xinnet.com/domain/api.gb?method=DomainDNSAdd
&charset =utf-8    (utf-8字符

集)
    描述:按照给定内容和格式,添加域名相关的解析记录;需要先判定提供的域名是否已经在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.xinnet.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.xinnet.com &ttl =3600 &prio =5
    返回信息参数说明:
        ret:返回值(100执行成功;120已有此记录;130参数内容有错误;140添加记录失败);
        reason:错误信息(操作成功则不会发送此参数!);
        domain-auth-Failed 域名不是该代理所有
    返回格式:
        添加成功:ret=100
        添加失败:ret=120
&reason =已有此记录

3.15 解析记录修改接口:
    POST 地址: http://api.xinnet.com/domain/api.gb?method=DomainDNSMod
           http://api.xinnet.com/domain/api.gb?method=DomainDNSMod
&charset =utf-8    (utf-8字符

集)
    描述:按照给定信息内容,修改对应的解析记录;
    参数说明:
        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.xinnet.cn 

&oldcontent =ns1.xinnetdns.com &ttl =3600
    说明:
        格式1表明的是将原有纪录内容ns1.xinnetdns.com更新为ns.xinnet.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 地址: http://api.xinnet.com/domain/api.gb?method=DomainDNSDel
           http://api.xinnet.com/domain/api.gb?method=DomainDNSDel
&charset =utf-8    (utf-8字符

集)
    描述:按照给定信息内容,删除对应的解析记录。
    参数描述:
        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.xinnet.cn
    返回信息参数说明:
        ret:返回值(100执行成功;125此记录不存在;130参数内容有错误;160删除记录失败);
        reason:错误信息(操作成功则不会发送此参数!);
        domain-auth-Failed 域名不是该代理所有
    返回格式:
        添加成功:ret=100
        添加失败:ret=160
&reason =删除记录失败


特别注意事项说明:
1、client和POST的来源IP必须与该代理填写的地址一致
2、checksum=MD5("Register"+client+password+dn+aemail+unit2)

dn    域名;1个,包括名字和后缀
client    代理号;1个
aemail    管理联系人电子邮件地址[必须]



验证:
client和POST的来源IP必须与该代理填写的地址一致
checksum=MD5("Register"+client+password+dn+aemail+uname2)

"Register"    为字符串常量,表示接口名称。其他没有引号表示为POST参数变量
password    为代理专区中设置的认证密码
client    为客户号
dn    为域名
aemail    为管理联系人电子邮件
unit2    为注册单位英文名称



本文转自远哥博客园博客,原文链接:http://www.cnblogs.com/taven/archive/2009/09/05/1560697.html,如需转载请自行联系原作者
相关文章
|
1月前
|
新能源 API 开发者
车辆限行查询API的实战指南:让限行管理从此 “有码可循”
随着全国机动车保有量突破4.53亿辆,交通拥堵与污染问题日益严峻,各城市陆续实施限行政策。探数API推出的车辆限行查询服务覆盖200+城市,提供实时限行数据,包括本地/外地燃油车及新能源车的限行规则、区域和时间等信息。其功能涵盖单个城市限行政策查询与支持城市的全面列表,助力用户精准规划出行。通过HTTP POST请求即可轻松接入,适用于导航平台和个人开发者。在“双碳”目标下,该API推动绿色出行与智能交通发展,为个人、企业和城市治理提供高效解决方案。
133 5
|
2月前
|
人工智能 JSON 安全
VIN码查询_标准版API:帮助解锁车辆的“身份证”详细信息的实战指南
VIN码(车辆识别号码)是由17位字母和数字组成的全球唯一编码,相当于汽车的“身份证”。通过解析VIN码,可获取品牌、车系、生产年份等关键信息。探数API平台的VIN码查询API(标准版),只需输入VIN码即可返回完整车辆配置信息。 该API适用于多种场景:电商平台可自动填充商品详情,提升准确性;维修行业能精准匹配零件与诊断需求;二手车市场则增强交易透明度与安全性。其调用流程简单,包括准备VIN码、构造请求、处理响应及异常处理。 VIN码不仅是查询工具,更是连接制造、销售、维修、保险等环节的纽带。
113 6
|
1月前
|
JSON 供应链 API
商品条码查询 API 实战指南:掌握商品“唯一身份标识”
商品条码查询API简介:基于1974年诞生的条码技术,该API通过输入13/14位条码,快速获取商品基本信息(名称、品牌、规格等)和成分信息(营养成分、配料表等)。其核心功能包括商品条码查询接口与成分查询接口,广泛应用于零售、电商、物流及健康饮食等领域。支持HTTP POST请求,提供便捷的代码调用示例。作为数字化转型的重要工具,它不仅方便消费者查询商品详情,还助力商家优化库存管理与销售流程,提升运营效率。
319 3
|
1月前
|
人工智能 5G 定位技术
如何使用基站查询API帮你解析地理位置?
随着“新基建”战略推进,我国已建成全球领先的移动通信网络。基于基站数据的LBS定位服务成为各行业数字化转型的重要工具。探数平台基站查询API整合三大运营商数据,提供高精度、低延迟的地理位置查询服务,广泛应用于位置推荐、物流追踪等领域。本文详细介绍该API的核心功能、返回字段及调用流程,并通过Python示例展示使用方法。未来,随着5G和AI技术发展,基站定位将迈向厘米级精度,赋能自动驾驶、工业物联网等前沿领域,助力开发者抢占位置经济的战略高地。
337 1
|
1月前
|
人工智能 数据可视化 物联网
物流轨迹订阅查询API调用全流程
本文介绍了物流轨迹订阅查询 API 从传统物流到智慧物流的转型价值与应用。该接口支持主流快递公司,通过标准化数据格式返回物流状态与详细路径信息,助力物流可视化、智能调度和精准客服。核心功能包括基于快递单号查询物流状态与轨迹,提供如快递公司、运单号、签收状态等关键信息。同时,文章还提供了调用流程及 Python 示例代码,便于开发者集成使用。未来,随着 AI 和物联网技术的发展,物流轨迹查询将向智慧物流生态演进,进一步提升行业效率与用户体验。
139 0
|
3月前
|
存储 JSON API
深入研究:淘宝天猫商品详情查询API详解
淘宝开放平台提供一系列API接口,帮助开发者获取淘宝商品的详细信息并集成到自有应用中。主要功能包括:获取单个商品详情(item_get)、评论信息(item_review)、快递费用(item_fee)、等。此外,还支持搜索商品(item_search)、按图搜索(item_search_img)、优惠券查询(item_search_coupon)、类目信息(item_cat_get)等功能。返回数据通常为JSON格式,包含商品标题、价格、库存、主图链接等基本信息,以及HTML格式的详细描述内容,方便开发者解析与展示。
|
5月前
|
存储 API 文件存储
单页图床HTML源码+本地API接口图床系统源码
图床系统是一种用于存储和管理图片文件的在线服务。它允许用户上传图片文件,并生成相应的图片链接,从而方便用户在网页、社交媒体或其他平台上分享图片。
172 2
单页图床HTML源码+本地API接口图床系统源码
|
5月前
|
数据采集 JSON 监控
速卖通商品列表接口(以 AliExpress Affiliate 商品查询 API 为例)
以下是使用 Python 调用速卖通商品列表接口(以 AliExpress Affiliate 商品查询 API 为例)的代码示例。该示例包含准备基础参数、生成签名、发送请求和处理响应等关键步骤,并附有详细注释说明。代码展示了如何通过公共参数和业务参数构建请求,使用 HMAC-SHA256 加密生成签名,确保请求的安全性。最后,解析 JSON 响应并输出商品信息。此接口适用于商品监控、数据采集与分析及商品推荐等场景。注意需通过 OAuth2.0 获取 `access_token`,并根据官方文档调整参数和频率限制。
|
24天前
|
JSON API 数据格式
淘宝商品评论API接口,json数据示例参考
淘宝开放平台提供了多种API接口来获取商品评论数据,其中taobao.item.reviews.get是一个常用的接口,用于获取指定商品的评论信息。以下是关于该接口的详细介绍和使用方法:
|
3月前
|
JSON 数据挖掘 API
1688API最新指南:商品详情接口接入与应用
本指南介绍1688商品详情接口的接入与应用,该接口可获取商品标题、价格、规格、库存等详细信息,适用于电商平台开发、数据分析等场景。接口通过商品唯一标识查询,支持HTTP GET/POST请求,返回JSON格式数据,助力开发者高效利用1688海量商品资源。