直通车下单

BusTicketOrder直通车下单

接口说明

HTTPS请求方式:POST

url:https://www.dllyfw.com/OpenApi/BusTicketOrder

使用调试工具调试该接口
参数说明
参数 类型 长度 可空 描述
apiKey string 32 由官方平台提供的apiKey
busTicketData json - Json格式的busTicketData对象数组(例如:客人要从A站点到C站点,中途经停B站点),格式如下:
[
    {
    "DepartId": A站点Id,
    "ArriveId": C站点Id,
    "ProductId": 产品Id,
    "DepartDate": A站的发车日期,
    "BusSchedule": A站的发车时刻,
    "throughSections": 途径路程对象数组字符串
    }
]
                    
上面busTicketData对象中的throughSections对象字符串,格式如下:
[
    {
    "Date": A站点发车日期,
    "BusLineId": A站点到B站点的线路Id,
    "DepartId": A站点Id,
    "ArriveId": B站点Id,
    "Schedule": A站的发车时刻
    },
    {
    "Date": B站点发车日期,
    "BusLineId": B站点到C站点的线路Id,
    "DepartId": B站点Id,
    "ArriveId": C站点Id,
    "Schedule": B站的发车时刻
    }
]
                    
请参见Demo
ticket json - 特定格式的字符串(如:"1,1|2,1|3,0"),竖线隔开的三个内容分别是全票、半票、特惠票下单 标志和数量, (如第一个竖线前的1,1,第一个1表示全票标示符,第二个1表示订购数量;第二个竖线前的2,1,第一个2表示半票标示符,第二个1表示订购数量; 最后的3,0,第一个3表示特惠票标示符,第二个0表示订购数量;), 具体请参见Demo
productId int 4 直通车产品Id
tel string 30 客人电话
sign string 32

由apiSecret,与参数busTicketData、ticket、productId、freeChildren、tel生成的待签名字符串,通过MD5签名运算后的值。

注意:选填参数不参与签名运算

签名规则
freeChildren
(选填)
int 4 不占座免票儿童数
collectedIDNumber
(选填)
string 20 身份证号码(部分产品需要填写)
collectedContact
(选填)
string 20 取票人姓名(部分产品需要填写)
number
(选填)
string 32 对接方订单号

如果提供此参数,将存入我方订单中,方便对接方根据自己的订单号查询下单是否成功。

返回说明

Json格式的Result对象

{
    "ErrorCode": 0,
    "Success": true,
    "Message": null,
    "HasException": false,
    "Value": 123123222,
    "Tag": 3423321
}
返回值 描述
Success 本次调用是否成功
ErrorCode 错误代码
Message 失败时为异常信息,成功时为null
Value Number:订单号
Tag 客人消费码(验证码)
支持下单重试,但number参数必填(为对接方的订单号),如果没有填写number参数,视为新下单。
在带有number参数的情况下,我方会对此number进行判重检查,如果发现已经下过单,会将之前的订单返回 (Value为订单号,Tag为验证码,Success为False,Message为错误原因),