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为错误原因), |