标准化试点单位信息接口说明1范围方法名称getAllBzSdxmInfo.doc

标准化试点单位信息接口说明 1 范围 方法名称：getAllBzSdxmInfo (HttpServletRequest request, HttpServletResponse response) 获取试点项目已办结的标准化试点单位信息。 2 符号与缩略语 URI 统一资源标识符（Uniform Resource Identifier） URL 统一资源定位符（Uniform Resource Locator） XML 可扩展标记语言（Extensible Markup Language） 3 数据格式定义 3.1.1 接口响应方式 上海市质量技术监督局网上办事平台提供标准的接口（REST风格WEB API接口），上海市政府数据资源服务平台可以根据自身的需求定时/实时调用相应的接口。 接口响应的数据为json格式，编码方式采用UTF-8编码的方式。 例如： [{APPLY_ID:100000007625,APPLY_TYPE:apply_type_ny,APPLY_TYPE_DESC:农业,IDEA:同意576,ITEM_TYPE:BZ_SDXM,MATTER_NAME:上海市标准化试点项目,PRINCIPAL:华希563,SIGN_DATE:2017-08-25 13:56:53,UNIT_ID:333666999,UNIT_NAME:质监测试帐号}] 3.1.2 接口响应格式 示例： 1.接口获取数据成功：[{APPLY_ID:100000007625,APPLY_TYPE:apply_type_ny,APPLY_TYPE_DESC:农业,IDEA:同意576,ITEM_TYPE:BZ_SDXM,MATTER_NAME:上海市标准化试点项目,PRINCIPAL:华希563,SIGN_DATE:2017-08-25 13:56:53,UNIT_ID:333666999,UNIT_NAME:质监测试帐号}] 2.接口获取数据失败： {ERROR:”错误信息内容”} 3.1.3接口响应请求状态码 以下状态码只列出接口中遇到的普遍问题，可根据数据库建库规范中规定的范围增加。 通用状态码 相关说明 200 服务调用成功 400 请求格式错误 401 未授权访问 402 不可识别的verb 403 服务器拒绝访问 404 指定的资源未找到 408 请求超时 500 服务器内部错误 4.接口规范 4.1 采用协议 HTTP1.1（超文本传输协议） 超文本传输协议（HTTP）是一种为分布式，合作式，超媒体信息系统。它是一种通用的，无状态（stateless）的协议，除了应用于超文本传输外，它也可以应用于诸如名称服务器和分布对象管理系统之类的系统，这可以通过扩展它的请求方法，错误代码和报头来实现。HTTP的一个特点是数据表现形 式是可输入的和可协商性的，这就允许系统能被建立而独立于数据传输。 HTTP是一个客户端和服务器端请求和应答的标准（TCP）。客户端是终端用户，服务器端是网站。通常，由HTTP客户端发起一个请求，建立一个到服务器指定端口（默认是80端口）的TCP连接。HTTP服务器则在那个端口监听客户端发送过来的请求。 一旦收到请求，服务器（向客户端）发回一个状态行，比如HTTP/1.1 200 OK，和（响应的）消息，消息的消息体可能是请求的文件、错误消息、或者其它一些信息。 4.2 连接方式 （Request-URI）。POST提交的实体是请求URI的从属物，就好像一个文件从属于一个目录，一篇新闻文章从属于一个新闻组，或者一条记录从属于一个数据库。 GET方式： GET方法意思是获取被请求URI（Request-URI）指定的信息（以实体的格式）。如果 请求URI涉及到一个数据生成过程，那么这个生成的数据应该被作为实体在响应中返回，但这并不是过程的资源文本，除非资源文本恰好是过程的输出。 GET请求的响应是可缓存的。 在服务器端可以根据@GET方法来设置其连接方式。 4.3 技术实现 接口采用API技术实现，API技术规范事例详见附录A。  附录A （资料性附录） 语法格式： 获取试点项目已办结的标准化试点单位信息接口url：/shzjxzsp/gircs/bzSdxm/all?applyType=allsign= 信息参数名称描述： applyType：（必输入），共有3个值，all（所有），1（农业的示范性数据标志），0（非农业的示范性数据标志） （必输入）数字签名，加密，双方制约的字符串为：account=ZYFU123scretkey=zyptsyingSECRETkey123，加密方法请参照附录B的代码示例 接口完整url： /shzjxzsp/gircs/bzSd