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>