全国文化市场技术监管与服务平台项目服务接口规范全国文化市场技术监管与服务平台项目服务接口规范目 录1 范围 - 1 -2 数据交换方式 - 1 -3 服务工作方式 - 2 -4 服务调用过程与服务安全 - 4 -5 服务接口调用说明 - 5 -5.1 查询接口 - 5 -5.2 上传接口 - 8 -6 服务报文说明 - 29 -6.1 报文 - 29 -6.1.1 概述 - 29 -6.1.2 报文逻辑结构 - 30 -6.2 报文头及其编码 - 31 -6.2.1 服务代码（SERV_ID） - 31 -6.2.2 使用者代码（USER_ID） - 35 -6.2.3 口令 - 37 -6.2.4 新口令 - 37 -6.2.5 令牌 - 37 -6.2.6 服务返回代码（retcode） - 37 -6.2.7 返回消息 - 38 -6.3 报文体 - 38 -6.3.1 规则 - 38 -6.3.2 举例 - 43 -6.4 报文大小 - 45 -6.5 报文规范 - 45 -6.5.1 报文Xsd文件 - 45 -6.5.2 Wsdl文件 - 51 -6.6 业务报文数据说明 - 55 -6.6.1 概述 - 55 -6.6.2 数据类型说明 - 56 -6.6.3 标识 - 57 -6.6.4 机构编码和雇员编码 - 58 -6.6.5 组织机构 - 58 -6.6.6 准入业务数据 - 68 -6.6.7 执法业务数据 - 133 -6.6.8 查询接口 - 155 -1 范围本规范规定了全国文化市场技术监管与服务平台应用接口（服务接口）的使用方式、服务调用过程、服务接口及报文规范，用于指导全国文化市场技术监管与服务平台部中心与省中心系统或地方自建系统之间集成工作。
本规范引用标准文件GB／T 2260-2007中华人民共和国行政区划代码；WebService标准：WS-I Basic Profile 1.1、SOAP 1.2、WSDL 2.0、WS-Addressing 1.0； XML 1.02 数据交换方式部中心与分/省中心部署分为三种情况，完全采用文化部新建“全国文化市场技术监管与服务平台”建设的分/省中心平台；部分采用文化部新建“全国文化市场技术监管与服务平台”建设、部分采用自有系统建设的省中心平台；完全采用自有系统自建省中心平台对于不同的情况，其数据同步方式如下图所示其中，部署全国文化市场技术监管与服务平台的分/省中心与部中心之间数据同步采用定时任务，基于时间戳方式同步；对于部分采用全国文化市场技术监管与服务平台建设的省中心，需要首先通过服务接口将自有系统数据同步到省中心，然后通过定时任务，基于时间戳方式将数据同步到部中心；对于完全采用自有系统建设的省中心（上海、浙江），通过服务接口将数据同步到部中心3 服务工作方式下图箭头为服务调用方向全国文化市场技术监管与服务平台作为服务提供者，提供业务与技术服务，各个省中心自有系统作为服务使用者，调用全国文化市场技术监管与服务平台提供的认证、退出、修改密码、发送或获取业务数据服务。
服务分为技术服务与业务服务，技术服务包括认证服务、退出服务、修改密码服务；业务服务在“服务报文说明”一节有详细说明服务采用WebService作为服务实现方式，SOAP over HTTP作为通信协议，支持的WebService标准包括WS-I Basic Profile 1.1、SOAP 1.2、WSDL 2.0、WS-Addressing 1.0服务的具体要求请参见《5.5.2SDL文件》4 服务调用过程与服务安全服务调用过程如下：l 服务使用者首先需向服务提供者发起认证请求，认证通过后服务提供者向服务请求者提供令牌，并为服务使用者生成会话；l 每次服务调用返回时，服务提供者将新的令牌提供给服务使用者，随后的服务请求需使用最新的令牌，除认证外，服务使用者每次对服务提供者发起服务请求必须提供最新的令牌；l 不再使用服务时，服务使用者必须及时请求退出服务，以关闭会话；l 如果5分钟内没有活动的服务请求，会话自动关闭；l 服务使用者每次发起业务服务请求需要检查上次服务响应的返回码，检测会话是否建立，如果会话未建立，需首先认证，返回成功后再发起业务服务请求5 服务接口调用说明5.1 查询接口查询接口地址：（需登陆VPN）http://192.168.59.1:8080/webservice/services/FacadeServicePort?wsdl实现查询业务：业务名称函数名称主体queryMain(String xmlFile)个体演员queryACTOR(String xmlFile)个体经纪人queryBroker(String xmlFile)演出活动queryActor(String xmlFile)处罚结果queryResult(String xmlFile)黑名单queryBlacklist(String xmlFile)机型机种query063PROFINAL(String xmlFile)游戏产品-主体queryGame_Main(String xmlFile)游戏产品信息queryGame(String xmlFile)交办查询queryReportlist(String xmlFile)游戏动态监管queryGame_Anyuan(String xmlFile)音乐动态监管queryMUSIClist(String xmlFile)准入审批过程查询queryApproveInfo(String xmlFile)实例：上报XML字符串: 东方网新公司 文网文【2011】009号注：COMP_NAME、APPROVAL_NUM为《7.6.8查询接口》一节中列出的输入字段名。
客户端接收（XML文件已经生成，只需接收即可）： 东方网新公司 1 1 浙江省-杭州市-文杭区 中元路2号 1 2098-0987 12201109009722221 2000 ds@ 057166590988 王玉冰 1 身份证 422228197705214017 13561769098 2011-09-09 浙江省文化厅 文网文【2011】009号 注：多条数据以节点区分，COMP_NAME、ORGANIZE_TYPE等为《7.6.8查询接口》一节中列出的输出字段名。
5.2 上传接口1、上传接口地址：（需登陆VPN）http://192.168.59.1:8080/webservice/services/FacadeServicePort?wsdl2、上传业务：业务名称函数名称上传数据upload（String xmlName）3、Xml格式：XML：服务代码 使用者ID口令新口令令牌返回消息返回代码里为具体数据]]>4、格式说明：（1）服务代码（SERV_ID）：服务代码用于标识不同的服务，服务代码为必填项。
2）服务码编码规则：服务代码共占12个字符，其编码规则如下：类别代码（2位）+模块代码（2位）+功能代码（8位）类别编码与服务数量统计类别代码含义数量备注00系统服务301组织机构3省中心推送02准入业务类型24省中心推送03执法业务类型13省中心推送04查询接口10省中心查询合计53（3）服务代码表服务代码服务含义备注000100000001服务使用者认证，生成会话000100000002服务使用者退出，注销会话000100000003服务使用者修改密码010100000101机构010100000102人员010100000103装备020100000101经营主体基本信息020100000102个体演员信息020100000103个体经纪人信息020100000201主体关联信息-从业人员020100000202主体关联信息-股东信息020100000203主体关联信息-管理层信息020100000204主体关联信息-域名信息020100000205主体关联信息-设备信息。