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

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

2、（示例）必填备注RequestHeadersbi nfile-md5请求文件二进制流的MD5摘要，示例：bcf7837571fab538772f65b137b71b9dM文件md5摘要，用于数据元 整性校验bin file-gzitrue 或者 flaseO响应是否采用 GZIP压缩Pbin file-aut hTICKETM单位标识鉴权（格式：16位 英文字符串，不区分大小与）Content(FORMbi nFile传输文件的二进制流M文件流multipart/form-data; boun dary=in putstreamfile nameZW_CZKKZCX_REQ_20150617,

3、O233.js on1 M文件名文件命名规范，详见2.5Resp onse：请求header属性值（示例）必填备注ResponseHeadersbi nfile-md5响应文件二进制流的MD5摘要，示例：bef7837571fab538772f65b137b71b9dM文件md5摘要，用于数据元 整性校验Conten t-Disp ositi onattaehme nt;file name=ZW_CZKKZCX_RES_2015061710233.js on1 M与HTTP协议规定相冋，file name=返回的文件名文件命名规范，详见 2.5Conten t-E neo dinggzipO与

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

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

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

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

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

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

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