用户工具

站点工具


帮助:api

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

Both sides previous revision 前一修订版
后一修订版
前一修订版
帮助:api [2011/10/23 13:42]
756489530 [介绍]
帮助:api [2013/03/04 13:22] (当前版本)
refactor [设备认证]
行 1: 行 1:
-大家好是传奇小子 +====== 公云(3322)动态域名更新API ====== 
-认为俄警方三大困境的快乐感豆腐干地方大风过后岛谷科技豆腐干空间的风华高科都是符合公司的拉法基恶魔看了他的发挥viodfmtgiogb看vbg才vbgcbh烦得很让他富豪彼此vhbfthg斯蒂芬韩国法规汇编+ 
 +通过公云API,您可以很容易开发出动态域名客户端,或者将动态域名功能集成到自己的设备中。 
 + 
 +任何公云的账户,都可以使用动态域名API,如果您还没有注册公云,请[[http://​www.3322.net/​accounts/​signup/​|点此]]注册。 
 + 
 +===== 介绍 ===== 
 + 
 +  * Client的请求应该使用HTTP/​1.0以上协议,Server的响应一定为HTTP/​1.0 
 + 
 +  * Client 和 Server,​通过 HTTP GET 或 HTTP POST 请求进行交互。 
 + 
 +  * 需要事务处理,Client发送完整的请求,并且解析服务器端的相应,保证域名更新的成功。 
 + 
 +  * 如果请求失败,则需要延时一段时间(推荐1分钟)进行重试,直到域名更新成功。 
 + 
 +  * 更新请求的触发,有两种方式: 
 + 
 +事件驱动,客户端侦听系统的IP请求变化事件,一旦改变了IP,立即发起更新请求,推荐这种方式,更新没有延时。 
 + 
 +定时更新,每隔一定时间,发起更新请求,注意两次间隔时间不能短于1分钟(收费用户不能短于15秒),如果连续3次以上频繁请求,该域名会被系统自动封堵,返回 abuse 代码。 
 + 
 +  * IP的变化检测,可以采用 web 方式进行检测,客户端可以访问 http://​ip.3322.net 获取自己的IP,两次请求返回的IP变化了,就发起更新请求。注意访问 http://​ip.3322.net 的两次间隔时间不能短于1分钟,如果连续3次以上频繁请求,该IP会被系统自动封堵 
 + 
 +  * 使用[[http://​www.ietf.org/​rfc/​rfc2617.txt|HTTP]]验证作为API的用户身份验证方式。 
 + 
 +  * User-Agent, 代表客户端名称、版本,需要根据设备类型、名称、特征进行自定义,一般包括设备的厂家、型号、firmware版本号。请不要使用示范中的名称,否则可能被封堵。 
 + 
 ===== 动态域名更新接口 ===== ===== 动态域名更新接口 =====
  
行 47: 行 74:
 è¯¥å‚数可选,​ 使域名暂时失效。 è¯¥å‚数可选,​ 使域名暂时失效。
  
 +==== HTTP状态返回码 ====
 +HTTP状态返回码为200、4XX、5XX,其中4XX表示认证错误,500表示服务器内部出错,200表示正常请求。但是动态域名客户端
 +请忽略HTTP返回码,而是对下面的返回值进行解析。比如返回值"​interror"​表示内部出错,这时对应的HTTP状态返回码是500。
  
 ==== 返回值 ==== ==== 返回值 ====
行 73: 行 103:
  
   * notfqdn   * notfqdn
-没有提供域名参数,必须提供一个在小辣椒注册的动态域名域名。+没有提供域名参数,必须提供一个在公云注册的动态域名域名。
  
   * nohost   * nohost
行 85: 行 115:
  
   * !active   * !active
-该域名被系统关闭,请联系小辣椒客服人员。+该域名被系统关闭,请联系公云客服人员。
  
   * abuse   * abuse
-该域名由于段时间大量发送更新请求,被系统禁止,请联系小辣椒客服人员。+该域名由于段时间大量发送更新请求,被系统禁止,请联系公云客服人员。 
 + 
 +=== 服务器出错 ===
  
   * dnserr   * dnserr
-DNS æœåŠ¡å™¨æ›´æ–°å¤±è´¥+DNS æœåŠ¡å™¨æ›´æ–°å¤±è´¥ã€‚
  
 +  * interror
 +服务器内部严重错误,比如数据库出错或者DNS服务器出错。
  
 ===== 获取IP接口 ===== ===== 获取IP接口 =====
行 129: 行 163:
  
  
-小辣椒动态域名更新API简单易用,方便了开发者和集成商开发自己的客户端,给设备增加动态域名功能。+公云(3322)动态域名更新API简单易用,方便了开发者和集成商开发自己的客户端,给设备增加动态域名功能。
  
 ä½†æ˜¯å¦‚果对客户端的理解不深入,会产生一些错误或者更新失败,导致动态域名更新失败,用户无法通过域名访问设备。 ä½†æ˜¯å¦‚果对客户端的理解不深入,会产生一些错误或者更新失败,导致动态域名更新失败,用户无法通过域名访问设备。
  
-小辣椒为了规范域名的更新流程,保障设备的正常工作,对市场上使用小辣椒动态域名更新API的设备进行认证:+公云为了规范域名的更新流程,保障设备的正常工作,对市场上使用公云动态域名更新API的设备进行认证:
  
-  * ç”±å°è¾£æ¤’的工程师,对设备进行认真,全面的测试,保证设备能够在各种网络条件、各种异常条件下正常更新域名 +  * ç”±å…¬äº‘的工程师,对设备进行认真,全面的测试,保证设备能够在各种网络条件、各种异常条件下正常更新域名 
-  * æä¾›è®¤è¯çš„设备清单,推荐小辣椒的广大用户选用+  * æä¾›è®¤è¯çš„设备清单,推荐公云的广大用户选用
  
 è®¾å¤‡è®¤è¯çš„具体方法,请参见[[帮助:​设备认证|设备认证]] è®¾å¤‡è®¤è¯çš„具体方法,请参见[[帮助:​设备认证|设备认证]]
帮助/api.1319348553.txt.gz · 最后更改: 2011/10/23 13:42 由 756489530