V2 0/order long/add order group

来自技术开发小组内部wiki
跳转至: 导航搜索

功能说明

跟团游提交订单

URL

http://[域名]/v2/order_long/add_order_group

返回格式

支持json,xml.通过format参数来控制

HTTP请求方式

POST.可以post的数据为xml或json.

输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明。
(2)私有参数
参数名称 是否必须 类型 描述
date
必须
date 出行日期,yyyy-mm-dd格式
version
必须
string 客户端版本
adult_num
必须
int 成人数
child_num
必须
int
儿童数
product_id
必须
int
产品id
uid

int
用户id
type_name

string
产品类型:跟团游pack_group;自由行pack_free
receiver

string
收货人
mobile

string
手机号
email

string
邮箱
weixin

string
微信
identitys

string
身份信息,多个证件号用英文逗号(',')分隔
coupon_sn

string
优惠券号
postscript

string
订单备注
differ_status

bool
单房差是否选择:true是,false否
differ_num

int
单房差数量
referer

string
订单来源
scenerys

json
景点信息,格式如:[
    {
        "product_id": "305",
        "sell_id": "319",
        "supplier_id": "57",
        "date": "2016-01-16",//选择日期
        "num": "3"//份数
    }
],保险,用车,其他信息输入格式同景点一样,不在下方说明。(3.40添加)
insurances

json
保险信息,格式如:[{"product_id":"303","sell_id":"317","supplier_id":"57","date":"2016-01-28","num":"2"}](3.40添加)
cars

json
用车信息,格式如:[{"product_id":"303","sell_id":"317","supplier_id":"57","date":"2016-01-28","num":"2"}](3.40添加)
others

json
其他信息,格式如:[{"product_id":"303","sell_id":"317","supplier_id":"57","date":"2016-01-28","num":"2"}](3.40添加)
user_city_id

int
用户所属分站
share_id

int
分享id,分享产品被购买,必传(v3.72新增)

请求示例

正式环境
http://api.fumubang.com/v2_0/order_long/add_order_group
测试环境
http://api.fumubang.net/v2_0/order_long/add_order_group
本地环境
http://dev-api.fumubang.net/v2_0/order_long/add_order_group

返回参数说明

参数 说明
order_sn
订单号
sum_money
订单总金额
order_name
订单名称
play_time
出行时间
adult_num
成人数
child_num
儿童数
weixin
微信号
email
邮箱
receiver
联系人
mobile
电话
pay_time_limit
订单多长时间关闭
pay_time_remain
订单支付剩余时间,单位s

正确返回示例

{
    "order_sn": "20160121212858686221",
    "sum_money": "300.00",
    "order_name": "ccccc",
    "play_time": "2016-01-23 00:00:00",
    "adult_num": "2",
    "child_num": "0",
    "weixin": "",
    "email": "",

    "receiver":"候有法",

    "mobile":"18500191390",

  "pay_time_limit": "7200",//订单多长时间关闭
  "pay_time_remain": ​3708,////订单支付剩余时间,单位s
}

错误返回示例

实例1:

{ "error_code":"300001",

"error_msg":"参数错误,请重新选择日期"

}

实例2:

{

"error_code":"300001",

"error_msg":"请填写收货人"

}
实例3: {

"error_code":"300001",

"error_msg":"请填写收货人手机号"

}

实例4: {

"error_code":"300001",

"error_msg":"哎呀,就填写订单的时间,商品卖光了,请购买其他商品。"

}

实例5: {

"error_code":"300001",

"error_msg":"该自由行机票无数据,请重新选择日期"

}

实例6: {

"error_code":"300001",

"error_msg":"该自由行机票无数据,请重新选择日期"

}