智能车载设备接入标准

接入原则

第三方使用曹操接入标准:企业外部第三方接入流程

坐标系采用高德坐标系

请求编码UTF-8

交互维护

以车辆为主维度与外部系统交互。 主要分为4个部分。

  1. 车辆设备信息同步、控制

  2. 服务状态通知

  3. 订单详情

  4. 对账

流程图

交互协议

  1. 曹操调用三方

    a. 车辆线上服务状态变更

    b. 车牌信息变更

    c. 查询订单详情

    d. 流媒体获取

    e. 流媒体列表获取

    f. 车辆维度对账

    g. 曹操跳转三方

  2. 第三方调用曹操

    a. 车载设备信息推送

    b. 订单生命周期

    c. 车辆位置信息推送

    d. 订单结束服务

    e. 异常监控 异常载客、车内纠纷

    f. ACK回调事件

重试机制

重要接口第三方调用曹操如果失败需要重试, 重试机制为http调用超时、网络异常或者开放平台返回了500错误码。重试丢弃必须在3次以上。

常量定义

特殊字段说明

字段名称 说明 最大长度 接口参考
caocaoOrderNo 曹操订单号 64 接口102
caocaoEventNo 曹操事件编号 64 接口105
ackEventNo ack事件编号 64 接口106

接口返回码

code int类型 描述
200 成功
404 暂未支持

设备类型

类型 int类型 描述
1 计价器
2 摄像头
3 顶灯

设备状态

类型int类型 描述
1
2