业务系统DBRRP接口说明

API接口说明

综述

商务中国(以下简称BizCn)业务系统接口以证书签名加密技术保证其安全传递,
系统通过签名密码传递加密技术并配合IP授权来保证与客户端的建立安全可靠的连接。
每个客户最大并行连接数为10;
每个连接可以进行任意多次的命令及结果返回的传输,
但如果一个连接在2小时之内没有进行任何的命令的传输, 系统将自动断开连接.
客户可以自己生成私钥文件(key文件), 和签名证书请求文件(csr文件), 发给BizCn,
BizCn将根据这个生成签名证书文件(crt文件), 及keystore文件发给客户;
BizCn也可以代客户生成这些文件, 但客户要提供相关资料(英文):
证书所要授予的网站, 单位名称, 国家, 省份, 城市, 联系EMAIL
等的英文资料.
BizCn的DBRRP系统有测试机和正式的生产机.
如果要测试和正式连接的话, 还要告诉我们在商务中国的帐号以及要和DBRRP连接的IP,
我们将对这IP进行授权, 每个帐号不超过3个IP, 连测试机和生产机的IP可以不同.
DBRRP的命令分为连接命令和业务命令,
连接命令形式如下:
Command<crlf>
[AttributeName:AttributeValue<crlf>]
.<crlf>
业务命令形式如下:
BusinessType<crlf>
Command<crlf>
EntityName:EntityValue<crlf>
AttributeName:AttributeValue<crlf>
.<crlf>
每个命令以
<crlf>
.<crlf>
结束, 结果的返回也是已这个结束.
所有的Command, BusinessType, EntityName, EntityValue, AttributeName不区分大小写.
AttributeValue区分.
各个业务命令将在各个业务DBRRP文档里更详细的说明.
连接命令主要有如下几个:
session
quit
describe
session:
session命令用来建立与BizCn DBRRP的会话连接, 具体格式如下:
session<crlf>
id:your login name<crlf>
password:login password<crlf> #用户在BIZCN系统的登陆密码或者密码MD5加密后编码
.<crlf>
<crlf>为c语言中的\r\n
以下<crlf>同此意.
该命令的返回:

成功:

200 Command completed successfully<crlf>	成功
.<crlf>	结束

连接的IP错:

531 Wrong IP connection<crlf>	连接的IP错
.<crlf>	结束

用户或密码验证错

531 Authorization failed<crlf>	用户或密码验证错
.<crlf>	结束

连接数过多:

541 Too many connection<crlf>	连接数过多
.<crlf>	结束

只有建立起与BizCn DBRRP的会话连接, 才能进行其他的业务命令的传输.
建立起一个会话连接后, 可以在这连接进行任意多次的命令及结果返回的传输,
直到这个连接被断开.
quit:
quit命令用来退出会话连接, 具体格式如下:
quit<crlf>
.<crlf>
该命令的返回:
成功:
200 Command completed successfully<crlf>
.<crlf>
describe:
rrp描述命令, 具体格式如下:
describe<crlf>
.<crlf>
返回:
200 Command completed successfully<crlf>
Protocol: DBRRP 0.1<crlf>
.<crlf>
该命令可以做为一个IDLE命令, 当一个会话连接长时间没有命令传输时, 可以
发这个命令来保持连接的存在.
业务命令的BusinessType有如下几个值
domainname, dnsresolve, url_forward, corpmail, vhost, keyword
domainname用来做域名的查询, 注册, 修改等.
dnsresolve用来做域名的解析记录增加变更删除等(域名的DNS必须时dns.bizcn.com).
url_forward用来做域名的url转发, 当然必须把用来做转发的host解析到218.5.77.25.
corpmail用来做集团邮局的开设及管理
vhost用来做虚拟主机的开设及管理
keyword用来做通用网址的查询注册修改续费等.
chinesedomain中文通用域名(中文.cn)的查询注册修改等。