接口说明

  1. 通过该接口可以完成接机下单

接口地址

https:// <Partner_DOMAIN>/<CallBackURL>

请求方式

POST

请求参数

名称 类型 是否必选 说明
channel string yes 渠道名称(标识首约调用)
serviceType string yes 服务类型(接机:3)
partnerOrderNo string yes 首约订单号
bookingDate string yes 预定日期时间,10位时间戳(秒数)
cityId string yes 城市ID
groupIds string yes 选购车型如34
priceMark string no 预估返回的价格标识
bookingStartAddr string yes 上车地点
bookingStartPointLo string yes 上车地点经度坐标
bookingStartPointLa string yes 上车地点纬度坐标
bookingEndAddr string yes 下车地点
bookingEndPointLo string yes 下车地点经度坐标
bookingEndPointLa string yes 下车地点纬度坐标
riderName string no 乘车人姓名,URLEncode编码后的
riderPhone string no 乘车人手机号 (此手机号可能为空或不准确,请一定以确认使用司机时传递的乘客虚拟号为准,创建司乘绑定关系
bookingUserId int no 预订人用户id(乘车人手机号为空时,此字段必填)
phoneLastFour String no 乘客真实手机号后4位
cancelFeeFlag int yes 是否收取取消费:1-是,其他-否
airlineNum String yes 航班号
planDate string yes 航班计划出发日期,格式(yyyy-MM-dd HH:mm:ss)
airlineDate string no 航班预计到达日期,格式(yyyy-MM-dd HH:mm:ss) (注:这里指的预计落地的时间,并非官网航班固定计划时间)
depCode string yes 出发地三字码
arrCode string yes 目的地三字码
extData String no JSON格式字符串。如{"buyoutFlag":1}。具体说明见下方
sign string yes 参见sign生成算法

extData扩展项

名称 类型 是否必选 说明
buyoutFlag int no 一口价标识,1为一口价
supportModifyStart int no 修改上车点标识位,1为支持
supportModifyDestination int no 修改下车点标识位,1为支持
supportModifyPassingpoints int no 修改/新增途经点标识位,1为支持

返回数据

名称 类型 说明
result string 0:成功;非0:失败原因编码
errmsg string 失败原因描述,若成功则值为空
data OrderResultDTO 下单结果,参见OrderResultDTO

返回示例

{
    "result": 0,
    "errmsg": "SUCCESS",
    "data": {
        "orderId": "198813025",
        "orderNo": "B7518002632952624",
        "returnCode": "0"
    }
}
Copyright © 首约科技(北京)有限公司 2020 all right reserved,powered by Gitbook该文件修订时间: 2024-09-10 08:00:38

results matching ""

    No results matching ""