V1/user/my order list

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

功能说明

获取订单列表数据

URL

http://[域名]/v1/user/my_order_list

返回格式

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

HTTP请求方式

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

输入参数说明

参数名称 是否必须 类型 描述
uid int 用户id
type int 类型 0全部 1未付款 2已付款 3待发货 4待分享 5退款
page int 当前页
pagesize int 每页显示条数
app string 如果传的参数是 child,就返回母婴问答中的精品订单

请求示例

正式环境
http://api.fumubang.com/v1/user/my_order_list
测试环境
http://api.fumubang.net/v1/user/my_order_list
本地环境
http://dev-api.fumubang.net/user/my_order_list

返回参数说明

参数 说明
list 订单列表数据
page 分页信息

客户端业务逻辑注意事项

1.当为同商家合并订单情况,订单关闭情况下的"重新购买"按钮点击后 直接跳转到该订单下第一个票务对应的活动页,和web页的操作保持同步

正确返回示例

订单列表 list对象示意图 list:[订单信息1,订单信息2.......]

{
"list": [
{
"order_sn": "20141106085547159466", //订单编号
"order_status": "7", 订单状态
"sum_money": "¥1.01", //订单金额
"shape_type": "1", <span style="color:#FFA500">//当shape_type=2时,为实体票,返回物流信息字段order_shipping_url(v3.72版本及以上支持)</span>
"order_shipping_url":"",<span style="color:#FFA07A">//查询物流H5链接</span>
"order_status_name": "待付尾款",
"order_ctime": "2014-11-06 08:54",
"is_partner_order":0,//是否结伴行订单:1是,0否
"is_share":0,//是否可以分享,0否1是
"order_status_pay":true,<span style="color:#800000">//是否可以继续支付,ture是,false否(PS:当order_status=7并且order_status_pay=false并且pay_source="pay_times"时,不能支付)</span>
"activity":[//票务列表    
{
"aid": "100341",
"banner": "<a href="http://img3.fumubang.net/huodong/banner/X20140516164935129.jpg">http://img3.fumubang.net/huodong/banner/X20140516164935129.jpg</a>",
"title": "Joanna_电子票1",
"sub_title": "Joanna_电子票1"<span style="color:#FF0000">,//副标题</span>
"sum_money":3,
"app_activity": "3",
"ticket_type":"1" //票务类型:1演出2景点3通用4酒店
},
 "type": 1, //分享类型:1订单2报名(3.50版本新增)
 "is_share": 1,//是否可以分享:1是0否
 "style": "2",//模板类型:1单天2多天3自定义(自定义类型没有模板向导)
 "template_ext": [//模板向导list
    {
       "steid": "35",
       "stid": "13",
       "day": "1", //第几天
       "descriptions": "第一天,旅途还顺利不" //描述
     },...
   ]
,
{
"aid": "100341",
"banner": "<a href="http://img3.fumubang.net/huodong/banner/X20140516164935129.jpg">http://img3.fumubang.net/huodong/banner/X20140516164935129.jpg</a>",
"title": "Joanna_电子票2",
"sub_title": "Joanna_电子票1",
      "sum_money":3,
"app_activity": "3",
"ticket_type":"1"//票务类型:1演出2景点3通用4酒店
},............
]
},........
],
"page": {
"page": 1,
"pagesize": 10,
"count": "203"
},
"order_share_info": { //待分享的引导图 和 规则链接
  "image": "<a href="http://dev-m.fumubang.net/temp/images/app/order_share_choice.png">http://dev-m.fumubang.net/temp/images/app/order_share_choice.png</a>", //图片地址
  "link_url": "<a href="http://dev-m.fumubang.net/mobile/hd_credit/credit_help">http://dev-m.fumubang.net/mobile/hd_credit/credit_help</a>"//规则链接
}
}


注:

order_status = 0时存在的按钮有:<span style="color:red">立即支付</span>,<span style="color:red">取消</span>

order_status = 6时存在的按钮有:<span style="color:red">重新购买</span>

order_status = 2&&shape_type=2时存在的按钮有:<span style="color:red">确认收货</span>
判断订单是普通订单还是酒店订单条件:<span style="color:#FF0000">activity数组长度为1,且activity[0].ticket_type=4 就是酒店订单</span>

错误返回示例

<?xml version="1.0" encoding="utf-8"?>

 <error_code>300001</error_code>
 <error_msg>暂无信息</error_msg>

<?xml version="1.0" encoding="utf-8"?>

 <error_code>300000</error_code>
 <error_msg>参数不全</error_msg>

示例代码