深圳市网络预约出租汽车监管系统.docxVIP

深圳市网络预约出租汽车监管系统 人证车证核验接口协议 二〇一八年十二月 交换规则 1.1. 设计原则 为避免网约车监管平台与网约车公司平台互为服务端进行双向通 信时带来的部署方式局限， 接口协议设计时尽量采用网约车监管平台 为服务端的模式。单一服务端的设计方式有利于接口服务的 “微服务” 化，方便后期业务发展带来的接口扩展。 1.2. 协议标准 内网数据传输采用 HTTP/HTTPS协议标准，互联网数据传输采 用 HTTPS。 基于 HTTP POST方式进行数据请求 , 编码格式统一为 UTF-8 编 码。 协议对 HTTP 协议做适当扩充，但不改变已有 HTTP 标准的任 何定义，实现者可以充分利用实现语言的 HTTP 开发包。 1.3. 传输协议说明 Request： 请求 属性名 值(示例 ) 必填 备注 请求文件二进制流的 MD5 摘 要，示例： 文件 md5 摘要，用于数据完 Request binfile-md5 M 整性校验 bcf7837571fab538772f65b13 Headers 7b71b9d binfile-gzi “true ”或者“ flase ” O 响应是否采用 GZIP 压缩 p binfile-aut TICKET M 单位标识鉴权（格式： 16 位 h 英文字符串， 不区分大小写） 文件流 binFile 传输文件的二进制流 M multipart/form-data; Content boundary=inputstream （FORM） ZW_CZKKZCX_REQ_2015061711 文件名 filename M 0233.json 2.5 文件命名规范，详见 Response： 请求 header 属性 值(示例) 必填 备注 响应文件二进制流的 MD5摘 要，示例： 文件 md5 摘要，用于数据完 binfile-md5 M 整性校验 bcf7837571fab538772f65b1 37b71b9d attachment;filename= 与 HTTP 协议规定相同， Content-Disp filename= 返回的文件名 Response ZW_CZKKZCX_RES_201506171 M osition 10233.json Headers 文件命名规范，详见 2.5 Content-Enco gzip O 与 HTTP协议规定相同 ding Content-Leng Content-Length:492 M 数据长度 th HTTP响应状态 0～ 999 M 响应码，详见 2.4 1. 请求成功时为返回文件的二进制流。 文件流或者 UTF-8 编码的字 Content M 符串 2. 当状态码 =700 时返回错误信息字符串 1.4. 响应码定义 (Response Headers Status Code) 响应码 描述 HTTP自定义返回码（≤ 600）： 200 （成功） 服务器已成功处理了请求。 201 （已创建） 请求成功并且服务器创建了新的资源。 202 （已接受） 服务器已接受请求，但尚未处理。 （非授权信息） 服务器已成功处理了请求， 但返回的信息可能来自另 203 一来源。 204 （无内容） 服务器成功处理了请求，但没有返回任何内容。 205 （重置内容） 服务器成功处理了请求，但没有返回任何内容。 206 （部分内容） 服务器成功处理了部分 GET 请求。 300 （多种选择） 针对请求，服务器可执行多种操作。 301 （永久移动） 请求的网页已永久移动到新位置。 （临时移动） 服务器目前从不同位置的网页响应请求， 但请求者应继 302 续使用原有位置来进行以后的请求。 （查看其他位置） 请求者应当对不同的位置使用单独的 GET 请求来 303 检索响应时，服务器返回此代码。 （未修改） 自从上次请求后， 请求的网页未修改过。 服务器返回此响 304 应时，不会返回网页内容。 （使用代理） 请求者只能使用代理访问请求的网页。 如果服务器返回 305 此响应，还表示请求者应使用代理。 （临时重定向） 服务器目前从不同位置的网页响应请求， 但请求者应 307 继续使用原有位置来进行以后的请求。 400 （错误请求） 服务器不理解请求的语法。 401 （未授权） 请求要求身份验证。 403 （禁止） 服务器拒绝请求。 404 （未找到） 服务器找不到请求的网页。 405 （方法禁用） 禁用请求中指定的方法。 406 （不接受） 无法使用请求的内容特性响应请求的网页。 （需要代理授权） 此状态代码与 401 （未授权）类似， 但指定请求者 407 应当授权使用代。 408 （请求超时） 服务器等候请求时发生超时。