ICPIP地址域名信息备案管理系统企业系统接口规范V3.1

工业和信息化部

ICP/IP地址/域名信息备案管理系统企业系统接口规范（3.1版）

2015年12月

目录

1、引言 (1)

1-1、目的 (1)

1-2、条件与限制 (1)

1-3、名词解释 (1)

1-4、规范性引用 (3)

2、接口功能 (5)

2-1、备案数据上报 (5)

2-2、备案数据下载 (6)

2-3、是否备案查询 (7)

2-4、备案密码校验 (7)

2-5、核验材料采集码获取接口 (8)

3、接口说明 (9)

3-1、接口概述 (9)

3-2、接口版本说明 (10)

3-3、接口说明 (10)

3-3-1、isp_upload方法 (10)

3-3-1-1、服务请求地址 (10)

3-3-1-2、方法原型 (10)

3-3-1-3、方法描述 (10)

3-3-1-4、参数描述 (12)

3-3-1-5、返回值 (12)

3-3-2、isp_download方法 (13)

3-3-2-1、服务请求地址 (13)

3-3-2-2、方法原型 (13)

3-3-2-3、方法描述 (13)

3-3-2-4、参数描述 (14)

3-3-2-5、返回值 (15)

3-3-3、isp_downloadack方法 (16)

3-3-3-1、服务请求地址 (16)

3-3-3-2、方法原型 (16)

3-3-3-3、方法描述 (16)

3-3-3-4、参数描述 (17)

3-3-3-5、返回值 (17)

3-3-4、isp_querypreviousupload方法 (17)

3-3-4-2、方法原型 (18)

3-3-4-3、方法描述 (18)

3-3-4-4、参数描述 (18)

3-3-4-5、返回值 (19)

3-3-5、isp_querybeianstatus方法 (20)

3-3-5-1、服务请求地址 (20)

3-3-5-2、方法原型 (20)

3-3-5-3、方法描述 (20)

3-3-5-4、参数描述 (20)

3-3-5-5、返回值 (21)

3-3-6、isp_verifybamm方法 (22)

3-3-6-1、服务请求地址 (22)

3-3-6-2、方法原型 (23)

3-3-6-3、方法描述 (23)

3-3-6-4、参数描述 (23)

3-3-6-5、返回值 (24)

3-3-7、isp_getcollectcode方法 (24)

3-3-7-1、服务请求地址 (24)

3-3-7-2、方法原型 (24)

3-3-7-3、方法描述 (24)

3-3-7-4、参数描述 (25)

3-3-7-5、返回值 (26)

3-4、接口返回状态代码表 (27)

3-5、数据处理结果代码表 (28)

4、数据格式 (35)

4-1、上报备案数据格式 (35)

4-1-1、ICP上报数据格式 (35)

4-1-1-1、新增备案 (36)

4-1-1-2、新增网站 (38)

4-1-1-3、新增接入 (39)

4-1-1-4、变更备案 (40)

4-1-1-5、注销备案 (43)

4-1-1-6、上报真实性核验材料电子件 (43)

4-1-1-7、核验材料接入商核实结果 (44)

4-1-1-8、核实结果 (44)

4-1-1-9、未备案网站处理结果 (44)

4-1-2、IP上报数据格式 (45)

4-1-2-2、修改IP备案 (48)

4-1-2-3、删除IP备案 (51)

4-1-3、域名上报数据格式 (51)

4-1-3-1、新增域名备案 (51)

4-1-3-2、修改域名备案 (52)

4-1-3-3、删除域名备案 (53)

4-2、下载备案数据格式 (53)

4-2-1、ICP下载数据格式 (54)

4-2-1-1、ICP备案数据 (54)

4-2-1-2、注销数据 (56)

4-2-1-3、黑名单列表 (57)

4-2-1-4、非法接入黑名单信息 (57)

4-2-1-5、未备案网站信息 (57)

4-2-1-6、备案结果 (58)

4-2-1-7、核实任务 (59)

4-2-1-8、核验材料 (61)

4-2-1-9、核查结果 (62)

4-2-1-10、相关通知信息 (63)

4-2-2、IP下载数据格式 (63)

4-2-2-1、IP来源备案结果数据 (64)

4-2-2-2、IP分配且使用备案结果数据 (64)

4-2-2-3、自带IP广播备案结果数据 (65)

4-2-2-4、自带IP备案结果数据 (66)

4-2-2-5、IP越界核查结果备案数据 (67)

4-2-2-6、IP冲突核查结果备案数据 (67)

4-2-2-7、IP未报核查结果备案数据 (67)

4-2-3、域名下载数据格式 (67)

4-2-4、基础代码下载数据格式 (68)

4-2-4-1、报备单位代码表 (68)

4-2-4-2、单位分类代码 (69)

4-2-4-3、单位性质代码 (69)

4-2-4-4、区域代码 (69)

4-2-4-5、意见反馈分类代码 (69)

4-2-4-6、管局信息 (70)

4-2-4-7、行业分类代码 (70)

4-2-4-8、行政级别代码 (70)

4-2-4-9、证件类型代码 (71)

4-2-4-10、网站经营类型代码 (71)

4-2-4-12、网站接入方式代码 (71)

4-2-4-13、注销理由代码 (72)

4-2-4-14、域名类型代码 (72)

4-2-4-15、核实意见代码 (72)

4-2-4-16、未备案独立域名处理代码 (72)

4-2-4-17、真实性核验材料电子件附件文件格式代码 (72)

4-2-4-18、真实性核验材料电子件附件证件类型代码 (73)

4-2-4-19、语言类别代码 (73)

4-2-5、SJTB下载数据格式 (73)

4-2-5-1、同步ICP备案数据 (73)

4-2-5-2、同步IP备案数据 (76)

4-2-5-3、同步YM备案数据 (78)

4-2-5-4、同步基础代码数据 (79)

4-2-5-5、同步黑名单数据 (84)

4-3、企业获取备案信息核验材料采集码数据格式 (84)

5、附件：报备数据文件格式 (86)

1、引言

1-1、目的

本企业报备接口是在《工业和信息化部ICP/IP地址/域名信息备案管理系统企业系统接口规范》（版本V3.0）的基础上，根据工信部备案数据核查评定子系统的需求，补充了ICP、IP地址及域名报备单位使用企业系统向部备案管理系统（以下简称“部级系统”）、省备案管理系统（以下简称“省局系统”）上报备案信息数据，及从部备案管理系统、省备案管理系统获取备案管理信息数据的编程接口。该接口作为开发单位设计、开发企业备案管理系统的依据。

1-2、条件与限制

接口使用的XML文件的编码方式均为GBK；

建议企业使用Java语言开发调用报备接口的程序；

建议对上报和下载的频率进行适度控制。

1-3、名词解释

1-4、规范性引用

本规范引用以下文件中的条款。凡是注日期和版本的文件，其后续修改版本中的修改条款或新增条款均不适用于本规范，凡是不注日期或版本的文件，其最

新内容可适用于本接口规范。

1） ICP/IP地址/域名信息备案管理网站备案移动终端服务平台需求说明书(2015.12)

2）备案数据核查评定子系统需求说明书（2013.9.3）

3）工业和信息化部ICP/IP地址/域名信息备案管理系统新增业务需求说明书（2010.11.10）。

4）工业和信息化部ICP/IP地址/域名信息备案管理系统升级改造业务需求说明书V4.2（2009.9.15）。

5）《互联网信息服务管理办法》（中华人民共和国国务院令第292号）。

6）《中国互联网络域名管理办法》（信息产业部令第30号）。

7）《非经营性互联网信息服务备案管理办法》（信息产业部令第33号）。

8）《互联网IP地址备案管理办法》（信息产业部令第34号）。

9）《互联网站管理工作细则》（信部电[2005]501号）。

10）《互联网站管理协调工作方案》（信部联电[2006]121号）。

11）《关于互联网站ICP备案信息、IP地址信息资源共享工作的意见》（信电函[2006]75号文件）。

12）《电信网码号资源管理办法》（信息产业部令第28号）。

2、接口功能

本企业报备接口主要实现企业侧系统与部级系统、省局系统之间的备案数据交互。

备案数据交互主要涉及以下三个功能：

?备案数据上报

?备案数据下载

?是否备案查询

?备案密码校验

2-1、备案数据上报

企业侧系统将备案数据上报到省局系统或部级系统。

企业侧系统通过调用isp_upload()方法，将备案数据作为参数进行上报。通过备案数据上报功能可以将以下备案申请数据提交给省局系统：

?ICP备案管理

1）新增备案：向省局系统提出新增ICP备案申请。

2）新增网站：为已经完成备案的ICP主体增加新的网站。

3）新增接入：为已经完成备案的ICP网站增加新的接入。

4）变更备案：更新已完成备案的ICP主体、网站、域名或接入信息。

5）注销备案：注销已经完成备案的ICP备案记录，包括主体或网站。

6）上报真实性核验材料电子件。

7）核实结果：上报ICP备案信息的核实结果。

8）未备案网站处理结果：提交对未备案网站进行处理后的结果。

9）核验材料接入商核实结果。

10）变更接入：更新已完成备案网站的接入信息。

?IP备案管理

1）IP地址来源信息：IP来源信息的新增、修改与删除。

2）IP地址分配与使用信息：IP分配与使用信息的新增、修改与删除。

3）自带IP地址信息：自带IP信息的新增、修改与删除。

4）IP地址广播信息：IP广播信息的新增、修改与删除。

?域名备案管理

1）新增域名备案。

2）修改域名备案。

3）删除域名备案。

2-2、备案数据下载

企业侧系统到省局系统或部级系统下载备案结果数据。

企业侧系统通过调用isp_download()方法，将部级系统或省局系统下发给本企业的备案管理数据下载到企业侧系统。

通过备案数据下载可以获取以下数据：

?ICP备案数据

1）ICP备案数据。

2）注销数据。

3）黑名单列表。

4）非法接入黑名单信息。

5）未备案网站信息。

6）备案结果。

7）核实任务。

8）核验材料。

9）核查结果。

10）备案管理相关通知信息。

?IP备案数据

1）IP地址备案结果。

2）IP地址备案信息核查结果。

?域名备案数据

1）域名备案结果。

?基础代码数据

1）报备单位列表。

2）单位分类代码。

3）单位性质代码。

4）区域代码。

5）意见反馈问题分类代码。

6）管局信息。

7）行业分类代码。

8）行政级别代码。

9）证件类型代码。

10）网站经营类型代码。

11）网站服务类型代码。

12）网站接入方式代码。

13）注销理由代码。

14）域名类型代码。

15）核实意见代码。

16）未备案独立域名处理代码。

17）真实性核验材料电子件附件文件格式代码。

18）真实性核验材料电子件附件用途代码。

同步数据

1）ICP备案同步数据。

2）IP备案同步数据。

3）域名备案同步数据。

4）基础代码同步数据。

2-3、是否备案查询

企业侧系统到省局系统查询网站或主体是否已经备案。

企业侧系统将网站域名或主体证件号码作为参数，通过调用isp_querybeianstatus()方法，查询网站或主体是否已经备案。

2-4、备案密码校验

企业侧系统到省局系统校验备案密码是否正确。

企业侧系统将备案号和备案密码作为参数，通过调用isp_verifybamm()方法，校验备案密码是否正确。

2-5、核验材料采集码获取接口

企业侧系统到省局系统获取核验材料采集码提供给ICP用户。

企业侧系统通过调用isp_getcollectcode()方法，从省局系统获取备案信息核验材料采集码。

3、接口说明

3-1、接口概述

企业报备接口主要包含以下五个webservice方法：

?isp_upload()方法：企业侧系统通过调用本方法实现ICP、IP地址或域

名备案信息、未备案网站处理结果等信息的上报功能；

?isp_download()方法：企业侧系统通过调用本方法实现到部级系统或省

局系统下载ICP、IP地址或域名的备案结果、未备案网站、黑名单、基

础代码等信息的下载功能；

?isp_downloadack()方法：企业侧系统在调用isp_download()方法成功

下载数据后，通过调用本方法通知部级系统或省局系统已经成功接收到

isp_download()方法返回的数据文件；

?isp_querypreviousupload()方法：企业侧系统通过本方法查询本企业最

近一次上报的备案数据文件；

?isp_querybeianstatus()方法：企业侧系统通过调用本方法到省局系统

进行是否备案查询；

?isp_verifybamm()方法：企业侧系统通过调用本方法到省局系统进行备

案密码校验。

?isp_getcollectcode()方法：企业侧系统通过调用本方法从省局系统获

取备案信息核验材料采集码。

下图描述了企业侧系统向部级系统或省局系统上报或下载备案数据文件的示例：

上报数据

(Upload 方法)下载数据（Download ）

3-2、接口版本说明

接口函数使用的XML 格式数据含有接口版本信息，使用XML 根节点元素“version”属性的值进行标识。本次发布版本为V.3.1，所有依据本版规范生成的XML 文件须填写本版本号。

部级系统和省局系统的企业系统接口服务将校验当前系统支持的接口版本，版本校验通过后方能进行下一步处理，否则返回版本错误提示信息。

3-3、接口说明

3-3-1、isp_upload 方法

3-3-1-1、服务请求地址

http://服务器IP 地址/ISPWebService/upDownLoad?wsdl

3-3-1-2、方法原型

public String isp_upload (Long ispId, String userName, String randVal, String pwdHash, String beianInfo, String beianInfoHash, Long dataSequence, int encryptAlgorithm, int hashAlgorithm, int compressionFormat)

3-3-1-3、方法描述

该方法实现将企业侧系统的备案申请等数据提交到部级系统、省局系统。 企业侧系统在调用该接口方法之前，首先要产生长度为20个字节的随机字符串（数字和大、小写字母），并将口令与该随机字符串连接（例如，口令是字

符串“1234567890”，生成的随机字符串是“abcdefghij”，那么连接后的结果是字符串“1234567890abcdefghij”）。将连接后的结果转换为GBK编码的二进制数据，使用hashAlgorithm定义的哈希算法进行哈希计算，得到参数pwdHash 的值作为认证信息。

企业侧系统在调用该方法上报备案数据时，一次调用只能上报一个XML格式的数据文件，并且所上报的XML数据文件大小不能超过50MB，单个XML数据文件内的备案数据不能超过1000条。企业侧系统上报的数据文件必须满足本规范所附的XSD格式规范。

企业侧系统上报的数据文件名必须使用英文字母或数字，文件名长度不超过128个字节。

企业侧系统在上报完数据文件后，应保存该数据文件3个月以上，以保证系统处理文件出现错误时重新上传数据文件。

企业侧系统要对需要上报的备案信息按照附件“企业上报数据格式.xsd”指定的格式编制XML文件，然后依序进行如下处理：

1）对XML文件使用参数compressionFormat指定的压缩格式进行压缩；

2）对压缩后的信息使用参数hashAlgorithm指定的哈希算法计算哈希值，并对哈希值进行base64编码运算形成beianInfoHash；

3）如需加密上传，则对压缩后的信息使用参数encryptAlgorithm指定的加密算法加密，并对加密结果进行base64编码运算形成beianInfo；如不

加密上传，则直接对压缩后的信息进行base64编码运算形成beianInfo。

3-3-1-4、参数描述

本方法共使用10个参数，各项参数的描述如下表所示：

3-3-1-5、返回值

该方法返回一个XML数据流（数据格式详见文件“企业上报数据方法调用返

回数据格式.xsd”），其中描述了本次操作的结果代码、结果描述。

如果操作成功，则返回以下信息：

msg_code参见第3-4节的接口返回状态msg_code代码表。

3-3-2、isp_download方法

3-3-2-1、服务请求地址

http://服务器IP地址/ISPWebService/upDownLoad?wsdl

3-3-2-2、方法原型

public String isp_download (Long ispId, String userName, String randVal, String pwdHash , int hashAlgorithm)

3-3-2-3、方法描述

通过该方法，企业侧系统可以下载部级系统或省管局系统下发的备案管理数据文件。

企业侧系统在调用该接口方法之前，首先要产生长度为20个字节的随机字符串（数字和大、小写字母），并将口令与该随机字符串连接（例如，口令是字符串“1234567890”，生成的随机字符串是“abcdefghij”，那么连接后的结

果是字符串“1234567890abcdefghij”）。将连接后的结果转换为GBK编码的二进制数据，使用hashAlgorithm定义的哈希算法进行哈希计算，得到参数pwdHash 的值作为认证信息。

部级系统或省局系统接收到企业侧系统的下载请求后，将需要下发给该企业的备案管理数据文件（文件格式参见“企业下载数据格式.xsd”）依次进行如下处理：

1）对XML数据文件使用指定的压缩格式进行压缩；

2）对压缩后的信息使用哈希算法计算哈希值，然后对哈希值进行base64编码运算；

3）如需加密下载，则对压缩后的信息使用指定的加密算法加密，然后对加密结果进行base64编码运算；如不加密下载，则直接对压缩后的信息进

行base64编码运算形成beianInfo。

部级系统或省局系统将上述处理后的哈希值、编码运算后的加密（或者明文）结果、哈希算法、加密算法、压缩格式返回给企业系统（详见“企业下载数据格式.xsd”）。

3-3-2-4、参数描述

本方法共使用5个参数，各项参数的描述如下表所示：

3-3-2-5、返回值

该方法返回一个XML数据流（数据格式详见文件“企业下载数据方法调用返回数据格式.xsd”），其中描述了本次操作的结果代码、结果描述。

如果成功，返回以下信息：

着对解码后的信息使用encryptAlgorithm指定的加密算法解密，在得到备案信息的压缩信息后，再使用hashAlgorithm指定的哈希算法计算哈希值，然后与beianInfoHash信息base64解码后的信息进行比较。如果比较一致，那么备案信息的完整性得到保证；如果比较不一致，则哈希值验证未通过，备案数据不完整。最后，在通过完整性校验后，使用compressionFormat指定的压缩格式对压缩后的信息进行解压缩，得到备案数据信息。