V2 0/order long/add order free

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

功能说明

自由行提交订单

URL

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

返回格式

支持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
hotels
 必须
 json

所选酒店信息：格式如：[
    {
        "product_id": "303", //产品id
        "sell_id": "317",//售卖id
        "supplier_id": "57",//供应商id
        "hotel_start_date": "2016-01-28",//酒店入住开始时间
        "hotel_end_date": "2016-01-30",//酒店入住结束时间
        "num": "2"//间数
    }
]


planes
 必须
 json
 机票信息，格式如：{
    "goods_price_max": "550.00",//机票最大价格
    "combo_id": "65"//机票组合id
}
scenerys
 必须
 json
 景点信息，格式如：[
    {
        "product_id": "305",
        "sell_id": "319",
        "supplier_id": "57",
        "date": "2016-01-16",//选择日期
        "num": "3"//份数
    }
]，保险，用车，其他信息输入格式同景点一样，不在下方说明。
insurances
 否
 json
 保险信息，格式如：[{"product_id":"303","sell_id":"317","supplier_id":"57","date":"2016-01-28","num":"2"}]
cars
 否
 json
 用车信息，格式如：[{"product_id":"303","sell_id":"317","supplier_id":"57","date":"2016-01-28","num":"2"}]
others
 否
 json
 其他信息，格式如：[{"product_id":"303","sell_id":"317","supplier_id":"57","date":"2016-01-28","num":"2"}]
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
 订单备注
referer
 是
 sting
 订单来源
user_city_id
 是
 int
 用户所属分站
share_id
 否
 int
 分享id,分享产品被购买，必传

请求示例

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

返回参数说明

参数 说明
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":"该自由行机票无数据，请重新选择日期"

}

取自“http://wiki.fumubang.net/index.php?title=V2_0/order_long/add_order_free&oldid=6397”