附件1：深圳市网络预约出租汽车监管平台数据接入规范（暂....DOCVIP

附件1 深圳市网络预约出租汽车监管平台 数据接入规范（暂行） 二〇一七年三月 版本历史 版本号修改日期修改描述V1.02016/9/9初稿v1.12016/9/141.个体驾驶员注册备案信息字段丰富、运输经营者注册备案信息字段丰富2.禁运驾驶员、车辆、运输经营者3个接口改为驾驶员、车辆、运输经营者证件变更信息3.企业管辖驾驶员明细和车辆明细改为独立接口4.增加违规信息接口v1.22016/11/29新增驾驶员变更明细接口、违规信息接口 个体驾驶员合同信息及运输经营者接入信息接口增加合同附件V1.32017/2/15新增3.5.5交通违法信息接口、3.5.6交通事故信息接口、3.7.12驾驶员证照动态接口、3.7.13车辆证照动态接口 修改3.7.10企业管辖驾驶员明细（增加企业信息相关字段）、3.7.11企业管辖车辆明细（增加企业信息相关字段）V1.42017/2/233.1.9增加黑名单原因字段 3.3.3 3.3.4 3.4.1 3.4.2 3.4.3 3.4.4 3.4.5增加网约车车辆运输证号字段 3.7.2增加合同不予签订原因字段 将3.7.12合并至3.7.7，将3.7.13合并至3.7.8 所有车牌号均不带“粤”字 一个文件中传输多条记录时平台返回的result值为true或falseV1.52017/3/23.1.5车辆里程信息增加车架号字段 3.6.3合乘订单信息接口增加合乘乘客信息字段 表示民族的字段，用汉字标识，加上“族”字，如“汉族”、“回族”等 licenseId字段表示驾驶员档案编号 所有字段命名规则均采用驼峰命名法V1.62017/3/73.3.3增加驾驶员姓名 3.3.4增加订单状态 3.7.1燃油类型代码更改交换规则 设计原则 为避免深圳市网络预约出租汽车监管平台（以下简称监管平台）与网约车公司平台互为服务端进行双向通信时带来的部署方式局限，接口协议设计时尽量采用监管平台为服务端的模式。单一服务端的设计方式有利于接口服务的“微服务”化，方便后期业务发展带来的接口扩展。 协议标准 内网数据传输采用HTTP/HTTPS 协议标准，互联网数据传输采用HTTPS。 基于HTTP POST方式进行数据请求,编码格式统一为UTF-8编码。 协议对 HTTP 协议做适当扩充，但不改变已有 HTTP 标准的任何定义，实现者可以充分利用实现语言的 HTTP 开发包。 传输协议说明 Request： 请求属性名值(示例)必填备注Request Headersbinfile-md5请求文件二进制流的MD5摘要，示例： bcf7837571fab538772f65b137b71b9dM文件md5摘要，用于数据完整性校验binfile-gzip“true”或者“flase”O响应是否采用GZIP压缩binfile-authTICKETM单位标识鉴权（格式：16位英文字符串，不区分大小写）Content （FORM）binFile传输文件的二进制流M文件流 multipart/form-data; boundary=inputstreamfilenameZW_CZKKZCX_REQ_20150617110233.jsonM文件名 文件命名规范，详见2.5 Response： 请求header属性值(示例)必填备注Response Headersbinfile-md5响应文件二进制流的MD5摘要，示例： bcf7837571fab538772f65b137b71b9dM文件md5摘要，用于数据完整性校验Content-Dispositionattachment;filename= ZW_CZKKZCX_RES_20150617110233.jsonM与HTTP协议规定相同，filename=返回的文件名 文件命名规范，详见2.5Content-EncodinggzipO与HTTP协议规定相同Content-LengthContent-Length:492M数据长度HTTP响应状态0～999M响应码，详见2.4Content1.请求成功时为返回文件的二进制流。 2.当状态码=700时返回错误信息字符串M文件流或者UTF-8编码的字符串 接口定义中3.1.1网约车平台公司支付信息，3.1.2网约车平台公司服务机构，3.1.3网约车平台公司运价信息， 3.5.5交通违法信息，3.5.6交通事故信息的传输方式为每个文件中一条记录，无需进行gzip压缩