《CNNIC发布的CN域名EPP接口说明文档》由会员分享，可在线阅读，更多相关《CNNIC发布的CN域名EPP接口说明文档（49页珍藏版）》请在金锄头文库上搜索。
1、Cn域名EPP-04-02注册系统客户端API说明书编 制 人：技术部支持组编制日期：2007年10月8日技术部审核人：审核日期： 年 月 日变 更 履 历序号变更对象变更发生时间变更类型变更内容变更记录人变更确认人大小1a参数值范围2008-7-15修改将createDomain命令中period的长度由Token (1-99)改为Token (1-120)刘昱琨刘昱琨b参数值范围2008-7-15修改将transferDomain命令中period的长度由Token (1-99)改为Token (1-120)刘昱琨刘昱琨c补充参数说明2008-7-15添加补充createDomain命令中
2、对于PERIOD_UNIT参数的说明刘昱琨刘昱琨d修订错误2008-9-22修改在updateContact命令中，对于扩展信息的修改server存在限制，并且更新cnnic的客户端的调用方法刘昱琨刘昱琨2a修订错误2010-11-14修改根据实际应用情况修改文档中API调用错误的代码刘昱琨刘昱琨注：大序号表示用户提出需求变更的次数序号 小序号表示每次需求变更引发的变更点的次数序号目录1.引言61.1.编写目的61.2.项目背景61.3.术语与缩写解释61.4.参考资料62.客户端API简介72.1.概述72.2.注意事项72.3.运行要求72.4.客户端API的基本结构73.客户端API各命
3、令调用方法93.1.与server建立SSL连接93.2.hello命令93.2.1.输入参数103.2.2.使用示例103.2.3.返回值说明103.3.login命令103.3.1.输入参数103.3.2.使用示例103.3.3.返回值说明103.4.logout命令113.4.1.输入参数113.4.2.使用示例113.4.3.返回值说明113.5.createDomain命令113.5.1.输入参数123.5.2.使用示例123.5.3.返回值说明133.6.checkDomain命令143.6.1.输入参数143.6.2.使用示例143.6.3.返回值说明143.7.infoDoma
4、in命令153.7.1.输入参数153.7.2.使用示例153.7.3.返回值说明153.8.renewDomain命令173.8.1.输入参数173.8.2.使用示例173.8.3.返回值说明173.9.updateDomain命令183.9.1.输入参数183.9.2.使用示例193.9.3.返回值说明203.10.deleteDomain命令203.10.1.输入参数213.10.2.使用示例213.10.3.返回值说明213.11.transferDomain命令213.11.1.输入参数213.11.2.使用示例213.11.3.返回值说明223.12.createContact命令
5、233.12.1.输入参数233.12.2.使用示例253.12.3.返回值说明253.13.checkContact命令263.13.1.输入参数263.13.2.使用示例263.13.3.返回值说明263.14.infoContact命令273.14.1.输入参数273.14.2.使用示例283.14.3.返回值说明283.15.updateContact命令303.15.1.输入参数303.15.2.使用示例313.15.3.返回值说明333.16.deleteContact命令333.16.1.输入参数333.16.2.使用示例333.16.3.返回值说明333.17.transfer
6、Contact命令333.17.1.输入参数333.17.2.使用示例343.17.3.返回值说明343.18.createHost命令353.18.1.输入参数353.18.2.使用示例353.18.3.返回值说明363.19.checkHost命令363.19.1.输入参数363.19.2.使用示例363.19.3.返回值说明373.20.infoHost命令373.20.1.输入参数383.20.2.使用示例383.20.3.返回值说明383.21.updateHost命令393.21.1.输入参数393.21.2.使用示例403.21.3.返回值说明403.22.deleteHost命
7、令403.22.1.输入参数403.22.2.使用示例413.22.3.返回值说明413.23.pollRequest命令413.23.1.输入参数413.23.2.使用示例413.23.3.返回值说明413.24.pollAck命令423.24.1.输入参数423.24.2.使用示例423.24.3.返回值说明434.联系我们445.附一 状态列表456.附二 转移操作类型477.附三 简写代码说明481. 引言1.1. 编写目的本文旨描述EPP-04-02英文域名注册系统客户端开发包的使用方法和注册系统中使用的命令输入及其响应。本文主要面向以下对象：l 注册系统客户端设计开发人员l 注册系
8、统客户端测试人员1.2. 项目背景域名类似于互联网上的门牌号码，是用于识别和定位互联网上计算机的层次结构式字符标识，与该计算机的互联网协议（IP）地址相对应。但相对于IP地址而言，更便于使用者理解和记忆。域名属于互联网上的基础服务，基于域名可以提供WWW、EMAIL、FTP等应用服务。中国互联网络信息中心(China Internet Network Information Center，简称CNNIC) 经国务院主管部门批准授权，负责我国域名体系的注册管理工作，负责运行和管理国家顶级域名CN系统、中文域名系统、通用网址系统及无线网址系统。目前CN域名注册系统是基于EPP协议（-04-02版）
9、。1.3. 术语与缩写解释EPP：Extensible Provisioning Protocol，可扩展供应协议。在本说明书中，为EPP -04-02版本。Registry：注册管理机构Registrar：注册服务机构，注册商Registrant：注册人，注册申请人RFC：Request for CommentsIETF：The Internet Engineering Task ForceToken：字符串数据类型，按照RFC标准约定。normalizedString：字符串数据类型，按照RFC标准约定。1.4. 参考资料1. Extensible Provisioning Protoco
10、l 2. Extensible Provisioning Protocol Transport Over TCP 3. Extensible Provisioning Protocol Domain Name Mapping 4. Extensible Provisioning Protocol Host Mapping 5. Extensible Provisioning Protocol Contact Mapping 2. 客户端API简介2.1. 概述CN EPP -04-02 API由CNNIC提供给注册服务机构，用于与CNNIC的CN顶极域名注册服务器进行通信。本文档用于说明该AP
11、I的使用方法。包括如何安装，注册系统中使用的命令输入及其响应以及使用示例等等。2.2. 注意事项本EPP API只提供基本的注册服务，不提供其他功能，比如注册的WEB服务。也就是说，不面向最终的注册用户，注册服务机构可以在此基础上开发新的服务来满足最终用户的需求。熟悉以下语言和协议有助于对EPP API的理解和使用：l JAVAl EPP (Extensible provisioning protocol)熟悉以下内容有助于理解本API的实现l XML2.3. 运行要求本API需要如下环境进行编译及运行J2SE 1.4+Xerces-J-2.9.0Apache-commons-lib2.4.
12、客户端API的基本结构客户端API主要由command包，entity包，response包和transport包组成。其中transport包负责客户端和服务器的通信，是开发上层注册客户端系统主要使用的包，其余各包主要作为对命令对象，协议对象和响应对象的封装使用。客户端API的基本结构如下所示：图 21客户端包基本结构Transport包中有2个类，分别是ClientSession.java：负责初始化注册商信息，并和服务器端建立连接通道,以及从建立的通道中发送和接受数据。EppSession.java：通过建立的通道向服务器发送各种EPP命令，接收服务器报文并转换为相应EppResponse对象。3. 客户端API各命令调用方法除客户端与server建立ssl连接以及发送命令时，server返回EppGreeting对象外，其余命令都会返回一个EppResponse类型对象，该对象包含命令的执行结果代码和代码的消息说明以及server端的交易识别号。3.1. 与server建立SSL连接 /创建一个新的sessionnet nic.edn.registrar.t
