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

工业和信息化部工业和信息化部 ICP IPICP IP 地址地址 域名信息备案管理系统域名信息备案管理系统 企业系统接口规范 企业系统接口规范 3 13 1 版 版 20152015 年年 1212 月月 I 目目 录录 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 II 3 3 4 1 服务请求地址 18 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 数据格式数据格式 34 4 1 上报备案数据格式 34 4 1 1 ICP上报数据格式 34 4 1 1 1 新增备案 35 4 1 1 2 新增网站 37 4 1 1 3 新增接入 38 4 1 1 4 变更备案 39 4 1 1 5 注销备案 41 4 1 1 6 上报真实性核验材料电子件 42 4 1 1 7 核验材料接入商核实结果 42 4 1 1 8 核实结果 43 4 1 1 9 未备案网站处理结果 43 4 1 2 IP上报数据格式 43 III 4 1 2 1 新增 IP 备案 44 4 1 2 2 修改 IP 备案 46 4 1 2 3 删除 IP 备案 48 4 1 3 域名上报数据格式 49 4 1 3 1 新增域名备案 49 4 1 3 2 修改域名备案 50 4 1 3 3 删除域名备案 51 4 2 下载备案数据格式 51 4 2 1 ICP下载数据格式 51 4 2 1 1 ICP 备案数据 52 4 2 1 2 注销数据 54 4 2 1 3 黑名单列表 54 4 2 1 4 非法接入黑名单信息 55 4 2 1 5 未备案网站信息 55 4 2 1 6 备案结果 55 4 2 1 7 核实任务 57 4 2 1 8 核验材料 58 4 2 1 9 核查结果 59 4 2 1 10 相关通知信息 60 4 2 2 IP下载数据格式 61 4 2 2 1 IP 来源备案结果数据 61 4 2 2 2 IP 分配且使用备案结果数据 62 4 2 2 3 自带 IP 广播备案结果数据 63 4 2 2 4 自带 IP 备案结果数据 64 4 2 2 5 IP 越界核查结果备案数据 64 4 2 2 6 IP 冲突核查结果备案数据 65 4 2 2 7 IP 未报核查结果备案数据 65 4 2 3 域名下载数据格式 65 4 2 4 基础代码下载数据格式 66 4 2 4 1 报备单位代码表 66 4 2 4 2 单位分类代码 67 4 2 4 3 单位性质代码 67 4 2 4 4 区域代码 67 4 2 4 5 意见反馈分类代码 67 4 2 4 6 管局信息 67 4 2 4 7 行业分类代码 68 4 2 4 8 行政级别代码 68 4 2 4 9 证件类型代码 68 4 2 4 10 网站经营类型代码 69 IV 4 2 4 11 网站服务类型代码 69 4 2 4 12 网站接入方式代码 69 4 2 4 13 注销理由代码 69 4 2 4 14 域名类型代码 70 4 2 4 15 核实意见代码 70 4 2 4 16 未备案独立域名处理代码 70 4 2 4 17 真实性核验材料电子件附件文件格式代码 70 4 2 4 18 真实性核验材料电子件附件证件类型代码 70 4 2 4 19 语言类别代码 71 4 2 5 SJTB下载数据格式 71 4 2 5 1 同步 ICP 备案数据 71 4 2 5 2 同步 IP 备案数据 74 4 2 5 3 同步 YM 备案数据 76 4 2 5 4 同步基础代码数据 77 4 2 5 5 同步黑名单数据 81 4 3 企业获取备案信息核验材料采集码数据格式 82 5 附件 报备数据文件格式附件 报备数据文件格式 84 1 1 1 引言引言 1 11 1 目的目的 本企业报备接口是在 工业和信息化部 ICP IP 地址 域名信息备案管理系 统企业系统接口规范 版本 V3 0 的基础上 根据工信部备案数据核查评定 子系统的需求 补充了 ICP IP 地址及域名报备单位使用企业系统向部备案管 理系统 以下简称 部级系统 省备案管理系统 以下简称 省局系统 上报备案信息数据 及从部备案管理系统 省备案管理系统获取备案管理信息 数据的编程接口 该接口作为开发单位设计 开发企业备案管理系统的依据 1 21 2 条件与限制条件与限制 接口使用的 XML 文件的编码方式均为 GBK 建议企业使用 Java 语言开发调用报备接口的程序 建议对上报和下载的频率进行适度控制 1 31 3 名词解释名词解释 词汇名称词汇名称词汇含义词汇含义 网站主办者互联网信息服务提供者的简称 主要指内容服务提供者 即 ICP 它包括单位 企业法人 政府和事业单位及其分支机构 办事机构 代表机构等 和个人 自然人 两类 通过证件类型 进行区分 接入服务提供者包括因特网接入服务业务经营者 即 ISP 因特网数据中心业 务经营者 即 IDC 以及以其他方式为网站提供接入服务的单位 增值电信业务经营者的统称 可简称接入商 域名注册管理机构是指承担顶级域名系统的运行 维护和管理工作的机构 域名注册服务机构是指受理域名注册申请 直接完成域名在国内顶级域名数据库中 注册 直接或间接完成域名在国外顶级域名数据库中注册的机构 域名报备单位域名注册管理机构 如 CNNIC 中国互联网络信息中心 境内域 名注册服务机构和境外域名注册服务代理机构 IP 报备单位是指直接从亚太互联网络信息中心等具有 IP 地址管理权的国际 机构获得 IP 地址的单位和具有分配 IP 地址供其他单位或个人使 用行为的单位 包括基础电信业务经营者 CNNIC 互联网接入 服务提供者 公益性互联网络单位等 备案地省 直辖市 自治区 管局 网站主体 即网站主办者 所在地省 直辖市 自治区 通信管 理局 2 接入地省 直辖市 自治区 管局 提供网站接入服务的接入服务提供者所在地所属省 直辖市 自 治区 通信管理局 代为备案由互联网接入服务提供者受委托代网站主办者履行备案手续的行 为 用户自行备案由网站主办者自己履行备案手续的行为 前置审批核验拟从事新闻 出版 教育 医疗保健 药品和医疗器械 文化 广播电影电视节目等互联网信息服务 根据法律 行政法规以及 国家有关规定应经有关主管部门审核批准 在履行备案手续时 还应向其接入服务提供者提交审批文件原件 由接入服务提供者 核验原件 并将批文批号 批文影印件通过系统提交给主办者所 在地省通信管理局 由前置审批部门通过省局系统查验审核真伪 这个过程称为前置审批核验 备案号和电子证书是指备案系统为网站主办者发放的用来表明其已履行网站备案手 续的序列号和证书文件 备案系统对外是以 ICP 为单位进行备案 对内是以主体为单位进行备案 一个主体多个网站备案时加网站 序列号 备案号采取主体与网站结合编码的方式 由三部分组成 省简写 ICP 备 主体序列号 网站序列号 经营性网站 省简写 ICP 证 主体序列号 网站序列号 注销自行注销 由网站主办者在企业侧系统发起 一 可以选择注销 网站接入 接入服务提供者去掉该备案信息中的本接入服务提供 者的接入信息 断开网络接入 二 可以选择注销主体 系统通 知其主体名下的所有接入服务提供者 备案号回收 备案库数据 相应变更 接入服务提供者注销 由接入服务提供者发起 注销网站接入信 息 效果是断开网络接入 并通过短信或邮件通知网站主办者 强制注销 也叫责令关闭网站 强制注销针对主体 网站或域 名 由各省通信管理局发起 吊销备案 省局系统通知其下所有 网站的所有接入服务提供者 效果是接入服务提供者切断其接入 并发出回执 处理结果是备案号回收 网站主办者进黑名单 其 关联的所有网站被关闭 Web 网站指有独立域名的 web 站点 包括 CN 和通用顶级域名 gTLD 下 的 web 站点 或没有域名只有 IP 地址的 web 站点 如果有多 个独立域名或多个 IP 指向相同的页面集 视为同一网站 以下 简称网站 WAP WAP Wireless Application Protocol 是无线应用协议的缩写 一种实现移动电话与互联网结合的应用协议标准 经营性网站提供经营性互联网信息服务的网站 非经营性网站提供非经营性互联网信息服务的网站 非经营性互联网信息服务 是指在中华人民共和国境内的组织或个人利用通过互联网域名访 问的网站或者仅能通过互联网 IP 地址访问的网站 提供非经营 性互联网信息服务 未备案网站是指将搜索到的网站的独立域名和系统中已报备的独立域名进行 比对 未获得备案号的就是未备案网站 违法违规网站符合 关于建立境内违法互联网站黑名单管理制度的通知 中第 一条描述的六种违规行为的一种或几种情形的境内互联网网站 单位网站互联网信息服务提供者为单位 企业法人 政府和事业单位及其 分支机构 办事机构 代表机构等 的网站 个人网站互联网信息服务提供者为个人 自然人 的网站 3 黑名单由于网站涉及违法违规而被管理部门列为重点监管或处理对象的 网站名单 独立域名是指用户在各顶级域 TLD 注册体系下直接注册的域名 具体 说明如下 对部分国家顶级域 以 CN 域名为例 即指用户在 CN 下直接注册的二级域名 如 SINA CN 或者在 信息产业部关 于调整中国互联网络域名体系的公告 信部电 2006 99 号和 信部电 2008 172 号 中规定的 CN 二级 类别域名 和 行政 区域名 下注册的三级域名 如 SINA COM CN SINA NET CN 等 对其他国家顶级域及通用顶级域 以 COM 域名为例 是指用户 在 COM 下直接注册的二级域名 如 SOHU COM 不包括 NEWS SOHU COM 中文顶级域名是指暂设的 中国 公司 网络 政府 和 公益 等 IP 地址是一种在 Internet 上给主机编址的方式 也称网际协议地址 由 32 位二进制数组成 单位网站互联网信息服务提供者为单位用户 企业法人 政府和事业单位 及其分支机构 办事机构 代表机构等 的网站 个人网站互联网信息服务提供者为个人用户 自然人 的网站 主体信息 网站信息 接入信息 详见 ICP 备案数据格式 空壳网站在备案系统已获得备案号 但没有接入服务提供者的网站 空壳主体在 ICP 库中无任何网站信息的备案主体 部级系统工业和信息化部开发的 ICP IP 域名信息备案管理系统的部级部 分 省局系统工业和信息化部开发的 ICP IP 域名信息备案管理系统的省局部 分 企业侧系统接入服务单位为落实接入责任而开发的企业部分的网站备案系统 自带 IP 地址是指 IP 地址使用单位从为其提供互联网接入服务的单位以外的 机构获得的 IP 地址 由为其提供互联网接入服务单位进行报备 标记自带 IP 地址 境内分配此段 IP 地址的单位也应进行报 备 标记为分配且使用 再分配 自带 IP 地址广播基础运营企业集团公司将省分公司提交上来的申请入网的自带 IP 地址在运营商网络进行广播 IP 地址自用IP 地址报备单位将申请的 IP 地址自己使用 IP 地址分配且使用IP 地址报备单位将 IP 地址分配给终端使用用户 IP 地址再分配IP 地址报备单位将 IP 地址分配给具有将 IP 地址进行再次分配 权限的单位 IP 地址预留IP 地址报备单位已申请获得的 IP 地址尚未分配 IP 地址来源信息IP 地址报备单位从上级分配单位所获得的 IP 地址信息 IP 地址分配及使用 信息 IP 地址报备单位从上级分配单位获得 IP 地址后 如何对这些 IP 地址进行分配或使用的信息 备案 APP提供备案相关服务的移动终端应用程序 备案信息核验材料采 集码 网站主办者用以上报备案信息核验材料的标识码 由省局系统根 据接入企业的申请生成 1 41 4 规范性引用规范性引用 本规范引用以下文件中的条款 凡是注日期和版本的文件 其后续修改版 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 号 5 2 2 接口功能接口功能 本企业报备接口主要实现企业侧系统与部级系统 省局系统之间的备案数 据交互 备案数据交互主要涉及以下三个功能 备案数据上报 备案数据下载 是否备案查询 备案密码校验 2 12 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 信息的新增 修改与删除 6 4 IP 地址广播信息 IP 广播信息的新增 修改与删除 域名备案管理 1 新增域名备案 2 修改域名备案 3 删除域名备案 2 22 2 备案数据下载备案数据下载 企业侧系统到省局系统或部级系统下载备案结果数据 企业侧系统通过调用 isp download 方法 将部级系统或省局系统下发给 本企业的备案管理数据下载到企业侧系统 通过备案数据下载可以获取以下数据 ICP 备案数据 1 ICP 备案数据 2 注销数据 3 黑名单列表 4 非法接入黑名单信息 5 未备案网站信息 6 备案结果 7 核实任务 8 核验材料 9 核查结果 10 备案管理相关通知信息 IP 备案数据 1 IP 地址备案结果 2 IP 地址备案信息核查结果 域名备案数据 1 域名备案结果 基础代码数据 1 报备单位列表 2 单位分类代码 7 3 单位性质代码 4 区域代码 5 意见反馈问题分类代码 6 管局信息 7 行业分类代码 8 行政级别代码 9 证件类型代码 10 网站经营类型代码 11 网站服务类型代码 12 网站接入方式代码 13 注销理由代码 14 域名类型代码 15 核实意见代码 16 未备案独立域名处理代码 17 真实性核验材料电子件附件文件格式代码 18 真实性核验材料电子件附件用途代码 同步数据 1 ICP 备案同步数据 2 IP 备案同步数据 3 域名备案同步数据 4 基础代码同步数据 2 32 3 是否备案查询是否备案查询 企业侧系统到省局系统查询网站或主体是否已经备案 企业侧系统将网站域名或主体证件号码作为参数 通过调用 isp querybeianstatus 方法 查询网站或主体是否已经备案 2 42 4 备案密码校验备案密码校验 企业侧系统到省局系统校验备案密码是否正确 8 企业侧系统将备案号和备案密码作为参数 通过调用 isp verifybamm 方 法 校验备案密码是否正确 2 52 5 核验材料采集码获取接口核验材料采集码获取接口 企业侧系统到省局系统获取核验材料采集码提供给 ICP 用户 企业侧系统通过调用 isp getcollectcode 方法 从省局系统获取备案信 息核验材料采集码 9 3 3 接口说明接口说明 3 13 1 接口概述接口概述 企业报备接口主要包含以下五个 webservice 方法 isp upload 方法 企业侧系统通过调用本方法实现 ICP IP 地址或域 名备案信息 未备案网站处理结果等信息的上报功能 isp download 方法 企业侧系统通过调用本方法实现到部级系统或省 局系统下载 ICP IP 地址或域名的备案结果 未备案网站 黑名单 基 础代码等信息的下载功能 isp downloadack 方法 企业侧系统在调用 isp download 方法成功 下载数据后 通过调用本方法通知部级系统或省局系统已经成功接收到 isp download 方法返回的数据文件 isp querypreviousupload 方法 企业侧系统通过本方法查询本企业 最近一次上报的备案数据文件 isp querybeianstatus 方法 企业侧系统通过调用本方法到省局系统 进行是否备案查询 isp verifybamm 方法 企业侧系统通过调用本方法到省局系统进行备 案密码校验 isp getcollectcode 方法 企业侧系统通过调用本方法从省局系统获 取备案信息核验材料采集码 下图描述了企业侧系统向部级系统或省局系统上报或下载备案数据文件的 示例 10 企 业 侧 系 统 部 省 局 系 统 企 业 侧 系 统 部 省 局 系 统 上上报报数数据据 U Up pl lo oa ad d方方法法 下下载载数数据据 D Do ow wn nl lo oa ad d isp downloadack返回 isp upload isp download isp download返回 isp downloadack isp upload返回 3 23 2 接口版本说明接口版本说明 接口函数使用的 XML 格式数据含有接口版本信息 使用 XML 根节点元素 version 属性的值进行标识 本次发布版本为 V 3 1 所有依据本版规范生 成的 XML 文件须填写本版本号 部级系统和省局系统的企业系统接口服务将校验当前系统支持的接口版本 版本校验通过后方能进行下一步处理 否则返回版本错误提示信息 3 33 3 接口说明接口说明 3 3 13 3 1 isp uploadisp upload 方法方法 3 3 1 13 3 1 1 服务请求地址服务请求地址 http 服务器 IP 地址 ISPWebService upDownLoad wsdl 3 3 1 23 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 33 3 1 3 方法描述方法描述 该方法实现将企业侧系统的备案申请等数据提交到部级系统 省局系统 企业侧系统在调用该接口方法之前 首先要产生长度为 20 个字节的随机字 符串 数字和大 小写字母 并将口令与该随机字符串连接 例如 口令是 11 字符串 生成的随机字符串是 abcdefghij 那么连接后的结果是字符 串 abcdefghij 将连接后的结果转换为 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 注 注 1 1 企业侧系统在上报备案信息数据文件时 需要对上报的数据进行编企业侧系统在上报备案信息数据文件时 需要对上报的数据进行编 号 该编号为号 该编号为 4 4 个字节长度的长整型值 初始值为个字节长度的长整型值 初始值为 1 1 每上报成功一 每上报成功一 次数据 该编号值递增次数据 该编号值递增 1 1 如果企业侧系统上报的数据编号跟上次数 如果企业侧系统上报的数据编号跟上次数 据上报的编号不连续 例如上次数据上报的编号为据上报的编号不连续 例如上次数据上报的编号为 500500 本次上报的 本次上报的 数据编号为数据编号为 502502 那么省局系统会返回状态 那么省局系统会返回状态 本次上载没有受理 本次上载没有受理 请首先上载漏报的数据 然后再上载本次数据请首先上载漏报的数据 然后再上载本次数据 同时对该次上报 同时对该次上报 数据不予接收处理 要求企业侧系统首先上报漏报的数据 例如上数据不予接收处理 要求企业侧系统首先上报漏报的数据 例如上 次数据上报的编号为次数据上报的编号为 500500 本次上报的数据编号为 本次上报的数据编号为 502502 那么省局系 那么省局系 统返回状态提示 要求企业侧系统首先上报 或重新上报 编号为统返回状态提示 要求企业侧系统首先上报 或重新上报 编号为 501501 的数据 的数据 2 2 本方法中数据加解密 计算哈希值和压缩本方法中数据加解密 计算哈希值和压缩 解压缩是指对数据解压缩是指对数据字节流字节流 的加解密 计算哈希值和压缩的加解密 计算哈希值和压缩 解压缩 解压缩 12 3 3 IPIP 报备流程中 报备流程中 IPIP 报备必须先报来源信息 再报分配信息 报备必须先报来源信息 再报分配信息 4 4 IPIP 报备中 报备中 IPIP 广播信息的报备是运营企业集团公司系统的报备功能 广播信息的报备是运营企业集团公司系统的报备功能 省级运营企业和其他接入商不报备此项信息 省级运营企业和其他接入商不报备此项信息 5 5 域名报备只针对域名报备单位 其他报备单位不报备此项信息 域名报备只针对域名报备单位 其他报备单位不报备此项信息 3 3 1 43 3 1 4 参数描述参数描述 本方法共使用 10 个参数 各项参数的描述如下表所示 参数名称参数名称参数类型参数类型参数描述参数描述 ispId 长整型 接入服务提供者的标识 可在部 省局系统的 公共查询中查询得到 userName 字符串 用户名 由企业所在省管局 或部管局 维护 管理 randVal 字符串 企业侧系统调用该方法时生成的随机字符串 长度是 20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串 进行哈希运算 然后进行 base64 编码运算得 到的结果 用户口令由企业所在省管局 或部 管局 维护管理 beianInfo 字符串对备案信息 XML 文件 格式参见 企业上报 数据格式 xsd 使用压缩算法进行压缩 再 对压缩后的信息进行加密 然后进行 Base64 编码运算得到的结果 beianInfoHash 字符串对备案信息 XML 文件 格式参见 企业上报 数据格式 xsd 压缩后进行哈希运算得到的 哈希值 dataSequence 长整型本次数据上报的数据编号 encryptAlgorithm 整型对称加密算法 hashAlgorithm 整型哈希算法 compressionFormat 整型压缩格式 encryptAlgorithm 描述如下表所示 算法标识算法标识算法描述算法描述 0 不进行加密 明文传输 1 AES 加密算法 加密模式使用 CBC 模式 补码方式采用 PKCS5Padding 密钥偏移量由部级系统 省局系统生成的字符串 如 60708 hashAlgorithm 描述如下表所示 算法标识算法标识算法描述算法描述 0 MD5 哈希算法 compressionFormat 描述如下表所示 算法标识算法标识算法描述算法描述 0 Zip 压缩格式 3 3 1 53 3 1 5 返回值返回值 该方法返回一个 XML 数据流 数据格式详见文件 企业上报数据方法调用 13 返回数据格式 xsd 其中描述了本次操作的结果代码 结果描述 如果操作成功 则返回以下信息 0 操作成功 如果操作错误 则返回以下信息 x 错误描述 本标签当 x 14 时存在 漏报的数据文件序号 msg code 参见第 3 4 节的接口返回状态 msg code 代码表 3 3 23 3 2 isp downloadisp download 方法方法 3 3 2 13 3 2 1 服务请求地址服务请求地址 http 服务器 IP 地址 ISPWebService upDownLoad wsdl 3 3 2 23 3 2 2 方法原型方法原型 public String isp download Long ispId String userName String randVal String pwdHash int hashAlgorithm 3 3 2 33 3 2 3 方法描述方法描述 通过该方法 企业侧系统可以下载部级系统或省管局系统下发的备案管理 数据文件 企业侧系统在调用该接口方法之前 首先要产生长度为 20 个字节的随机字 符串 数字和大 小写字母 并将口令与该随机字符串连接 例如 口令是 字符串 生成的随机字符串是 abcdefghij 那么连接后的结果是字符 14 串 abcdefghij 将连接后的结果转换为 GBK 编码的二进制数据 使用 hashAlgorithm 定义的哈希算法进行哈希计算 得到参数 pwdHash 的值作为认 证信息 部级系统或省局系统接收到企业侧系统的下载请求后 将需要下发给该企 业的备案管理数据文件 文件格式参见 企业下载数据格式 xsd 依次进行 如下处理 1 对 XML 数据文件使用指定的压缩格式进行压缩 2 对压缩后的信息使用哈希算法计算哈希值 然后对哈希值进行 base64 编码运算 3 如需加密下载 则对压缩后的信息使用指定的加密算法加密 然后对加 密结果进行 base64 编码运算 如不加密下载 则直接对压缩后的信息 进行 base64 编码运算形成 beianInfo 部级系统或省局系统将上述处理后的哈希值 编码运算后的加密 或者明 文 结果 哈希算法 加密算法 压缩格式返回给企业系统 详见 企业下载 数据格式 xsd 注 注 1 1 返回值返回值 XMLXML 流中的标签流中的标签 encryptAlgorithm encryptAlgorithm 为为 0 0 时 表示时 表示 beianInfo beianInfo 标签的内容是不加密的 为标签的内容是不加密的 为 1 1 时 表示时 表示 beianInfo beianInfo 标签的内容经过标签的内容经过 AESAES 加密算法的加密 加密模式使加密算法的加密 加密模式使 用用 CBCCBC 模式 补码方式采用模式 补码方式采用 PKCS5PaddingPKCS5Padding 密钥偏移量由部级系 密钥偏移量由部级系 统 省局系统生成的字符串 如统 省局系统生成的字符串 如 60708 60708 2 2 返回值返回值 XMLXML 流中的标签流中的标签 hashAlgorithm hashAlgorithm 为为 0 0 时 表示哈希算法是时 表示哈希算法是 MD5MD5 3 3 返回值返回值 XMLXML 流中的标签流中的标签 compressionFormat compressionFormat 为为 0 0 时 表示使用时 表示使用 ZipZip 压缩格式进行压缩 压缩格式进行压缩 4 4 本方法中数据加解密 计算哈希值和压缩本方法中数据加解密 计算哈希值和压缩 解压缩是指对数据解压缩是指对数据字节流字节流 的加解密 计算哈希值和压缩的加解密 计算哈希值和压缩 解压缩 解压缩 3 3 2 43 3 2 4 参数描述参数描述 本方法共使用 5 个参数 各项参数的描述如下表所示 参数名称参数名称参数类型参数类型参数描述参数描述 ispId 长整型 接入服务提供者的标识 可在部 省局系统的公共 查询中查询得到 userName 字符串 用户名 由企业所在省管局 或部管局 维护管 理 randVal 字符串企业侧系统调用该方法时生成的随机字符串 长 15 度是 20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进 行哈希运算 然后进行 base64 编码运算得到的结 果 用户口令由企业所在省管局 或部管局 维 护管理 hashAlgorithm 整型哈希算法 hashAlgorithm 描述如下表所示 算法标识算法标识算法描述算法描述 0 MD5 哈希算法 3 3 2 53 3 2 5 返回值返回值 该方法返回一个 XML 数据流 数据格式详见文件 企业下载数据方法调用 返回数据格式 xsd 其中描述了本次操作的结果代码 结果描述 如果成功 返回以下信息 0 操作成功 哈希算法 压缩格式 加密算法 省局系统的备案数据文件名 备案信息内容 备案信息的哈希值 企业侧系统收到上述数据后 首先对 beianInfo 信息进行 base64 解码 接 着对解码后的信息使用 encryptAlgorithm 指定的加密算法解密 在得到备案信 息的压缩信息后 再使用 hashAlgorithm 指定的哈希算法计算哈希值 然后与 beianInfoHash 信息 base64 解码后的信息进行比较 如果比较一致 那么备案 信息的完整性得到保证 如果比较不一致 则哈希值验证未通过 备案数据不 完整 最后 在通过完整性校验后 使用 compressionFormat 指定的压缩格式 16 对压缩后的信息进行解压缩 得到备案数据信息 如果操作错误 返回以下信息 x 错误描述 企业侧系统收到备案信息文件后 如果数据文件可以通过完整性校验 并 进行解压缩 则应该调用本接口规范中第 3 3 3 节的 isp downloadack 方法 将已正确接收到该文件的信息回执发送给部级系统或省局系统 msg code 参见第 3 4 节的接口返回状态 msg code 代码表 对于部级系统或省局系统处理企业上报的备案数据文件所产生的错误信息 均以数据文件下载形式返回给企业 数据中的错误信息详见 3 5 节数据处理结 果代码表 3 3 33 3 3 isp downloadackisp downloadack 方法方法 3 3 3 13 3 3 1 服务请求地址服务请求地址 http 服务器 IP 地址 ISPWebService upDownLoad wsdl 3 3 3 23 3 3 2 方法原型方法原型 public String isp downloadack Long ispId String userName String randVal String pwdHash int hashAlgorithm String fileName 3 3 3 33 3 3 3 方法描述方法描述 企业侧系统在调用 isp download 方法 成功下载备案管理数据文件完毕后 需要调用本方法 将已成功接收到下载文件的信息回执发送给部级系统或省局 系统 注 注 1 1 如果企业侧系统在调用如果企业侧系统在调用 isp downloadisp download 方法成功下载备案管理数据文方法成功下载备案管理数据文 件完毕后 不调用本方法将已成功接收到数据文件的信息回执发送件完毕后 不调用本方法将已成功接收到数据文件的信息回执发送 给部级系统给部级系统 省局系统 则部级系统省局系统 则部级系统 省局系统将在企业侧系统再次省局系统将在企业侧系统再次 调用调用 isp downloadisp download 方法时 继续发送该数据文件 方法时 继续发送该数据文件 17 2 2 本方法中计算哈希值是指对数据本方法中计算哈希值是指对数据字节流字节流的哈希值计算 的哈希值计算 企业侧系统在调用该接口方法之前 首先要产生长度为 20 个字节的随机字 符串 数字和大 小写字母 并将口令与该随机字符串连接 例如 口令是 字符串 生成的随机字符串是 abcdefghij 那么连接后的结果是字符 串 abcdefghij 将连接后的结果转换为 GBK 编码的二进制数据 使用 hashAlgorithm 定义的哈希算法进行哈希计算 得到参数 pwdHash 的值作为认 证信息 3 3 3 43 3 3 4 参数描述参数描述 本方法共使用 6 个参数 各项参数的描述如下表所示 参数名称参数名称参数类型参数类型参数描述参数描述 ispId 长整型 接入服务提供者的标识 可在部 省局系统的公共查 询中查询得到 userName 字符串用户名 由企业所在省管局 或部管局 维护管理 randVal 字符串 企业侧系统调用该方法时生成的随机字符串 长度是 20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进行哈 希运算 然后进行 base64 编码运算得到的结果 用 户口令由企业所在省管局 或部管局 维护管理 hashAlgorithm 整型哈希算法 fileName 字符串在 isp download 方法中已成功接收到的备案信息文 件名 hashAlgorithm 描述如下表所示 算法标识算法标识算法描述算法描述 0 MD5 哈希算法 3 3 3 53 3 3 5 返回值返回值 该方法返回一个 XML 数据流 详见文件 企业数据下载确认方法调用返回 数据格式 xsd 参照以下信息 x 返回信息描述 msg code 参见第 3 4 节的返回状态 msg code 代码表 3 3 43 3 4 isp querypreviousuploadisp querypreviousupload 方法方法 18 3 3 4 13 3 4 1 服务请求地址服务请求地址 http 服务器 IP 地址 ISPWebService upDownLoad wsdl 3 3 4 23 3 4 2 方法原型方法原型 public String isp querypreviousupload Long ispId String userName String randVal String pwdHash int hashAlgorithm 3 3 4 33 3 4 3 方法描述方法描述 企业侧系统调用 isp querypreviousupload 方法 查询本企业最近一次上 报的备案数据及其序号 注 注 1 1 本方法在企业侧系统出现故障后 可以使用本方法与部级系统或省本方法在企业侧系统出现故障后 可以使用本方法与部级系统或省 局系统进行通信参数的同步 企业侧系统在调用本方法得到数据文局系统进行通信参数的同步 企业侧系统在调用本方法得到数据文 件序号后 在下次上报数据文件时 使用的文件序号应为本方法返件序号后 在下次上报数据文件时 使用的文件序号应为本方法返 回的数据文件序号加回的数据文件序号加 1 1 2 2 企业侧系统在未进行数据上报操作时 调用本方法返回的数据文件企业侧系统在未进行数据上报操作时 调用本方法返回的数据文件 为空 文件序号为为空 文件序号为 0 0 企业侧系统在调用该接口方法之前 首先要产生长度为 20 个字节的随机字 符串 数字和大 小写字母 并将口令与该随机字符串连接 例如 口令是 字符串 生成的随机字符串是 abcdefghij 那么连接后的结果是字符 串 abcdefghij 将连接后的结果转换为 GBK 编码的二进制数据 使用 hashAlgorithm 定义的哈希算法进行哈希计算 得到参数 pwdHash 的值作为认 证信息 3 3 4 43 3 4 4 参数描述参数描述 本方法共使用 5 个参数 各项参数的描述如下表所示 参数名称参数名称参数类型参数类型参数描述参数描述 ispId 长整型 接入服务提供者的标识 可在部 省局系统的公共查 询中查询得到 userName 字符串用户名 由企业所在省管局 或部管局 维护管理 randVal 字符串 企业侧系统调用该方法时生成的随机字符串 长度是 20 字节 pwdHash 字符串 使用指定的哈希算法对用户密码和随机字符串进行哈 希运算 然后进行 base64 编码运算得到的结果 用 户口令由企业所在省管局 或部管局 维护管理 19 hashAlgorithm 整型哈希算法 hashAlgorithm 描述如下表所示 算法标识算法标识算法描述算法描述 0 MD5 哈希算法 3 3 4 53 3 4 5 返回值返回值 该方法返回一个 XML 数据流 详见文件 企业最近上载数据查询方法调用 返回数据格式 xsd 其中描述了本次操作的结果代码 结果描述 如果成功 返回以下信息 0 代码描述 哈希算法 压缩格式 加密算法 数据文件序号 上次上报的备案数据文件名 上次上报备案信息内容 备案信息的哈希值 企业侧系统收到上述数据后 首先对 beianInfo 信息进行 base64 解码 接 着对解码后的信息使用 encryptAlgorithm 指定的加密算法解密 在得到备案信 息的压缩信息后 再使用 hashAlgorithm 指定的哈希算法计算哈希值 然后与 beianInfoHash 信息 base64 解码后的信息进行比较 如果比较一致 那么备案 信息的完整性得到保证 如果比较不一致 则哈希值验证未通过 备案数据不 完整 最后 在通过完整性校验后 使用 compressionFormat 指定的压缩格式 对压缩后的信息进行解压缩 得到备案数据信息 如果操作错误 返回以下信息 20 x 错误描述 3 3 53 3 5 isp querybeianstatusisp querybeianstatus 方法方法 3 3 5 13 3 5 1 服务请求地址服务请求地址 http 服务器 IP 地址 BeianStatusWebService queryBeianStatus wsdl 3 3 5 23 3 5 2 方法原型方法原型 public String isp querybeianstatus Long ispId String userName String randVal String pwdHash int hashAlgorithm int queryConditionType String queryCondition 3 3 5 33 3 5 3 方法描述方法描述 企业侧系统可以通过该方法查询网站或主体的备案状态 即 是否已经完 成备案 如果网站已经备案 则返回该网站的网站名称 主体备案号和网站 备案号 如果主体已经备案 则返回该主体的主体备案号 注 本方法中计算哈希值是指对数据字节流的哈希值计算 注 本方法中计算哈希值是指对数据字节流的哈希值计算 企业侧系统在调用该接口方法之前 首先要产生长度为 20 个字节的随机字 符串 数字和大 小写字母 并将口令与该随机字符串连接 例如 口令是 字符串 生成的随机字符串是 abcdefghij 那么连接后的结果是字符 串 abcdefghij 将连接后的结果转换为 GBK 编码的二进制数据