这里会显示出您选择的修订版和当前版本之间的差别。
后一修订版 | 前一修订版 | ||
api [2011/08/04 17:08] refactor 创建 |
— (当前版本) | ||
---|---|---|---|
行 1: | 行 1: | ||
- | 小辣椒动态域名更新API | ||
- | |||
- | Client的请求应该使用HTTP/ | ||
- | |||
- | 需要事务处理,Client发送完整的请求,并且解析服务器端的相应,保证域名更新的成功 | ||
- | |||
- | 1. 通过URL认证 (所有的在一行) | ||
- | http:// | ||
- | |||
- | 2. HTTP GET 或 HTTP POST 请求 | ||
- | |||
- | 1) dyndns, statdns | ||
- | GET / | ||
- | Host: members.3322.org | ||
- | Authorization: | ||
- | User-Agent: myclient/ | ||
- | |||
- | 2) webhop | ||
- | GET / | ||
- | Host: members.3322.org | ||
- | Authorization: | ||
- | User-Agent: myclient/ | ||
- | |||
- | 3) subdom | ||
- | GET / | ||
- | Host: members.3322.org | ||
- | Authorization: | ||
- | User-Agent: myclient/ | ||
- | |||
- | 一些参数的注意: | ||
- | * username: | ||
- | 用户名和密码用来进行身份认证,必须使用 base64进行编码 | ||
- | |||
- | * User-Agent | ||
- | 客户端名称、版本,需要根据设备类型、名称、特征进行自定义,不要使用示范中的名称,否则可能被封堵 | ||
- | |||
- | |||
- | * system=dyndns|statdns|webhop|subdom System: | ||
- | 只能使用四者之一,否则出错。如果没有这个参数,缺省是dyndns | ||
- | |||
- | * hostname=host.3322.org System:All Optional: No | ||
- | 需要更新的域名 | ||
- | |||
- | * myip=ipaddr System: | ||
- | 域名对应的IP。如果不指定,则服务器将选择最佳的IP(一些Proxy会传递客户端的IP, | ||
- | 这会被服务器检测到)。如果传递的地址格式错误,则忽略这个参数,而用服务器检测 | ||
- | 到的IP。 | ||
- | |||
- | * wildcard=ON|OFF System: | ||
- | 是否支持泛域名(通配符),缺省为OFF。ON意为着 *.host.3322.org等同于host.3322.org | ||
- | |||
- | * mx=mailexchanger System: | ||
- | 指明Mail eXchanger。必须能够解析到一个IP,否则被忽略。如果不提供该参数或者 | ||
- | 不能解析到一个IP,mx记录会被删除。 | ||
- | |||
- | backmx=YES|NO | ||
- | 指明前面的mx参数会被设置成备份邮件服务器,即邮件会首先发送到你的机器上,如果 | ||
- | 不成功,才会发送到备份邮件服务器上。 | ||
- | |||
- | offline=YES|NO System: | ||
- | 使域名暂时失效。 | ||
- | |||
- | url=dest_url System: | ||
- | webhop指向的URL地址 | ||
- | |||
- | cloak=YES|NO System: | ||
- | 指明webhop时是否使用frame,将转向的url包装起来。缺省是YES | ||
- | |||
- | title=cloak_title System: | ||
- | cloak时,frame的标题。缺省是 " | ||
- | |||
- | ip1=address1 System: | ||
- | 第一个域名服务器的IP地址,必须是正确的IP。如果不指定,则服务器将选择最佳的IP | ||
- | (一些Proxy会传递客户端的IP, | ||
- | 则忽略这个参数,而用服务器检测到的IP。 | ||
- | |||
- | ip2=address2 System: | ||
- | 第二个域名服务器的IP地址,必须是正确的IP | ||
- | |||
- | |||