一号货车5月份需求服务端开发说明

一号货车

本文固定链接：https://www.zybuluo.com/ruiqh/note/367327

version 1.0.4

1.0.0 定义反选入参出参
1.0.1 重新修改部分字段定义
1.0.2 新增调用规则
1.0.3 新增取消订单结果码说明, 附近模块接口说明
1.0.4 新增常用司机接口说明
1.0.5 附近司机新增接活状态及上次上传位置时间
1.0.6 常用司机新增订单数字段
1.0.7 常用司机新增FuckId字段
1.0.8 常用司机新增PhoneNumber字段

反选排序

排序 减少 获取

接口

Orders.svc/RushTrucksWithOrderStatus

调用规则

接收到服务端推送时，立即调用
未接收到服务端推送时，距离上一次调用x秒后调用

入参

var truckIds = "id1|id2|id3|...";
//truckIds = ["id1","id2","id3"];

返回字段说明 complete short on bottom

{
    Code: 0,
    ErrMsg: "获取成功",
    Data:{
        CountDown:18.33,
        OrderId:"od1",
        OrderSelectInvertStaus:"1"
        ExcludeTrucks:[
            "truckId1",
            "truckId2",
            "..."
        ],
        Indexs: [
            "truckId1|`时间`|`距离`|`服务`",
            "truckId2|`时间`|`距离`|`服务`3",
            "..."
        ],
        Trucks:[
            {
                TruckId:"truckId1",
                CarNumber:"浙AD***2",
                Tags: [
                    { 
                        TagContents: ["高顶"] , 
                        TagType: "我的车辆状况"
                    },
                    {
                        TagContents: ["可进城"] , 
                        TagType: "我提供的服务"
                    }
                ],
                TruckPhoto:"http://www.yihaohuoche.com/smallimg.png",
                IsVplusTruck:true,
                TruckUserName:"张三",
                TruckRateScore:4.8,
                CarType:"小型厢货",
                OrderCount:10,
                RushDistance:10,    
                Price:100,
                Lwh:2.8*1.6*1.5
            }   
        ]
    }
}

缩减字段名称 是否可用

{
    code: 0,
    msg: "获取成功",
    data:{
        cd:18.33,
        od:"od1",
        oss:"1"
        ets:[
            "truckId1",
            "truckId2",
            "..."
        ],
        ins: [
            "truckId1|`时间`|`距离`|`服务`",
            "truckId2|`时间`|`距离`|`服务`",
            "..."
        ],
        ts:[
            {
                td:"truckId1",
                co:"浙AD***2",
                tas: [
                    { 
                        tc: ["高顶"] , 
                        tat: "我的车辆状况"
                    },
                    {
                        tc: ["可进城"] , 
                        tat: "我提供的服务"
                    }
                ],
                pt:"http://www.yihaohuoche.com/smallimg.png",
                isV:true,
                n:"张三",
                r:4.8,
                tt:"小型厢货",
                oc:10,
                rd:10,    
                pi:100,
                lwh:2.8*1.6*1.5
            }   
        ]
    }
}

取消订单返回结果优化

附近司机接口

接口

1. 查看司机手机号码　Truck.svc/LookTruckPhoneNumber
2. 分页附近司机信息 Truck.svc/LookNearbyTrucks

查看附近司机接口返回结果说明

分页附近司机信息接口说明

入参

出参

    {
      "la": 1433496553050,
      "io": true,
      "td": "3076c75e-8417-4b88-9b4f-2b0c25aa7b05",
      "n": "测试94",
      "pt": "",
      "isV": false,
      "tt": "小型厢货",
      "co": "沪M45548",
      "lwh": "2.8*1.6*1.5",
      "tas": [
        {
          "tat": "我的车辆状况",
          "tc": [
            "拆座",
            "尾板",
            "封闭车厢"
          ]
        },
        {
          "tat": "我提供的服务",
          "tc": [
            "小推车",
            "可进城",
            "可安装",
            "代收货款"
          ]
        }
      ]
    }

常用司机

接口

Truck.svc/LookFreqTrucks

入参

出参

出参

{
  "cs": [
    "上海市",
    "西安市"
  ],
  "recordCount": 2,
  "pageSize": 10,
  "pageCount": 1,
  "data": [
    {
      "r": 4.75,
      "tus": 1,
      "lst": 1462850656337,
      "l": {
        "c": "上海市",
        "x": 31.206264,
        "y": 121.270117
      },
      "td": "2534b377-108f-43ba-8b7f-c4e2c390729c",
      "n": "芮庆华",
      "pt": "36/phone-18858107536-Portrait-small.jpg",
      "isV": false,
      "pn":"18858107536",
      "tt": "小型厢货",
      "co": "破A123456",
      "lwh": "2.8*1.6*1.5",
      "oc":1
      "fi":"4c1a9152-dd9a-436b-b915-a6f8ade4b404"
      "tas": [
        {
          "tat": "我的车辆状况",
          "tc": [
            "高顶"
          ]
        },
        {
          "tat": "我提供的服务",
          "tc": [
            "可进城"
          ]
        }
      ]
    }],
  "code": 0,
  "msg": null
}