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

1、人证车证核验接口协议二0一八年十二月1 .交换规则1.1. 设计原则为避免网约车监管平台与网约车公司平台互为服务端进行双向通 信时带来的部署方式局限，接口协议设计时尽量采用网约车监管平台 为服务端的模式。单一服务端的设计方式有利于接口服务的“微服务” 化，方便后期业务发展带来的接口扩展。1.2. 协议标准内网数据传输采用HTTP/HTTP创、议标准，互联网数据传输采 用 HTTPS基于HTTP POSTy式进行数据请求，编码格式统一为UTF-8编 码。协议对HTTP协议做适当扩充，但不改变已有HTTP标准的任 何定义，实现者可以充分利用实现语言的HTTP开发包。1.3. 传输协议说明Reque

2、st:请求属性名值（示例）必填备注RequestHeadersbinfile-md5请求文件二进制流的MD5摘要，示例：bcf7837571fab538772f65b137b71b9dM文件 md5摘要，附于数据完 整性校验binfile-gzitrue 或者 flaseO响应是否采用 GZIP压缩Pbinfile-aut hTICKETM单位标识鉴权（格式：16位 英文字符串，不区分大小与）Content(FORMbinFile传输文件的二进制流M文件流multipart/form-data;boundary=inputstreamfilenameZW_CZKKZCX_REQ_2015061

3、710233.json1 M文件名文件命名规范，详见2.5Response：请求header属性值（示例）必填备注ResponseHeadersbinfile-md5响应义件一进制流的MD5摘要，示例：bcf7837571fab538772f65b137b71b9dM文件 md5摘要，附于数据完 整性校验Content-Disp ositionattachment;filename=ZW_CZKKZCX_RES_2015061710233.json1 M与HllP协议规定相同，filename=返回的文件名文件命名规范，详见 2.5Content-Enco dinggzipO与HTT的议规定相

4、同Content-Leng thM数据长度Content-Length:492HIIP响应状态0 999M响应码，详见2.4Content1 .请求成功时为返回文件的二进制流。2 .当状态码=700时返回错误信息字符串M文件流或者UTF-8编码的字 符串1.4. 响应码定义(Response Headers Status Code)响应码描述HIIP自定义返回码（W 600）:200（成功） 服务器已成功处理了请求。201（已创建）请求成功并且服务器创建了新的资源。202（已接受） 服务器已接殳请求，但尚未处理。（非授权信息）服务器已成功处理了请求，但返回的信息可能来自另203一来源。204（

5、无内容） 服务器成功处理了请求，但没有返回任何内容。205（重置内容）服务器成功处理了请求，但没有返回任何内容。206（部分内容）服务器成功处理了部分 GET请求。300（多种选择）针对请求，服务器可执行多种操作。301（永久移动）请求的网贝已永久移动到新位置。（临时移动） 服务器目前从不向位置的网页响应请求，但请求者应继302续使用原有位置来进行以后的请求。（查看具他位置）请求者应当对不向的位置使用单独的GET请求来303检索响应时，服务器返回此代码。（未修改） 自从上次请求后， 请求的网页未修改过。 服务器返回此响304应时，/、会返回网页内容。（使用代理） 请求者只能使用代理访问请求的网

6、页。如果服务器返回305此响应，还表示请求者应使用代理。（临时重定向） 服务器目前从不向位置的网页响应请求，但请求者应307继续使用原有位置来进行以后的请求。400（错误请求）服务器不理解请求的语法。401（未授权）请求要求身份验证。403（禁止） 服务器拒绝请求。404（未找到）服务器找不到请求的网页。405（方法禁用） 禁用请求中指定的方法。406（不接受）无法使用请求的内容特性响应请求的网页。（需要代理授权）此状态代码与401 （未授权）类似，但指定请求者407应当授权使用代。408（请求超时）服务器等候请求时发生超时。409（冲突）服务器在完成请求时发生冲突。410（已删除） 如果请求

7、的资源已永久删除，服务器就会返回此响应。411（需要有效长度）服务器不接受不含有效内容长度标头字段的请求。（未满足前提条件）服务器未满足请求者在请求中设置的其中一个前412提条件。（请求实体过大） 服务器无法处理请求， 因为请求实体过大， 超出服413务器的处理能力。（请求的URI过长）请求的URI （通常为网址）过长，服务器无法414处理。415（不支持的媒体类型）请求的格式不殳请求页面的支持。（请求范围不符合要求）如果页面无法提供请求的范围，则服务器会416返回此状态代码。417（未满足期望值）服务器未满足”期望”请求标头字段的要求。500（服务器内部错误）服务器遇到错误，无法完成请求。5

8、01（尚未实施）服务器不具备完成请求的功能。502（错误网关） 服务器作为网关或代理，从上游服务器收到无效响应。503（服务不可用） 服务器目前无法使用（由于超载或停机维护）。504（网关超时） 服务器作为网关或代理， 但是没有及时从上游服务器收 到请求。505（HIIP版本不受支持） 服务器不支持请求中所用的HIIP协议版本。系统服务返回码（错误码）（700949）:具体接口的错误码945不支持此类文件946晌应义件不存在947请求数据格式错误948请求文件名格式小止确949协议中未定义此类文件名系统服务预留返回码（950999）950鉴权失败951文件md5校验失败952格式校验失败953

9、请求文件为空999未知错误1.5. 文件命名规范文件名使用" 二进行分割，后缀为“ .json ”或者“ .gz”，当后缀为 “.gz”时，表 示是将json文件进行了 gzip压缩。文件名长度不超过100字节。文件命名规范：接口类型（标识唯一）命令请求或响应标识（REQ或RES）_._时间.json 。命令请求标识时间后缀REQ|RESyyyyMMddHHmmssSSS .json|.gzyyyyMMddHHmmssSSS .json|.gzREQ|RESyyyyMMddHHmmssSSS .json|.gz1.6. 数据格式及规范UTF-8编码格式的JSONt本，数据描述规范如下

10、:缩写定义说明M必填O可选根据实际情况填写2 .接口定义2.1. 接口地址测试地址：https:/ 4:1128api/app/common/binapi正式地址：2.2. 核验驾驶员证的接口请求文件名示例：LICENCE_RZHY_REQ_20180707161021295.json字段描述数据类型约束说明idCode证件号码varchar(32)是name驾驶员名称varchar(32)否响应文件名示例：LICENCE_RZHY_RES_20180707161021295.json字段描述数据类型约束说明result成功标识number是0/1errorMsg失败原因varchar(512)status驾驶员状态varchar(32)1:无证2:申请审核通过3:预约考试4:获得证书（有效）5:获得证书（无效）2.3. 核验车辆运输证的接口请求文件名示例：LICENCE_CZHY_REQ_20180707161021295.json字段描述数据类型约束说明licenceCode车牌号（去掉粤）varchar(128)是B1