V1/group tickets/get list info

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

功能说明

获取团购列表

URL

http://[域名]/v1/group_tickets/get_list_info

返回格式

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

HTTP请求方式

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

输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明。
(2)私有参数
参数名称 是否必须 类型 描述
city_id 必须 int 城市id
type 必须 int 类型 1=活动 2=演出 3=精品 4=旅游
area_id 可选 int 区域id
cid 可选 int 分类id
orderby 可选 int 排序(0:默认1:人气;2:销量; 3 价格)
page 可选 int 页码
pagesize 可选 int 每一页大小
app 可选 string app 如果是child 就返回母婴问答的数据
will_date
可选
date
出行日期:如‘2015-08-27’,只适用于旅行页面搜索。(v2.3版本加入)
age_min
可选
int
演出展览-最小年龄(v2.6版本加入)
age_max
可选
int
演出展览-最大年龄(v2.6版本加入)
show_time
可选
json
演出时间,json格式的数组(如["2015-11-26","2015-11-27"])
destination_province_id
可选
int
目的地-省份Id
destination_city_id
可选
int
目的地-市Id

请求示例

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

返回参数说明

参数 说明
cate_list 分类数据
area_list 区域列表
order_list 排序列表
tuan_list 团购列表
page 分页信息
count 活动总数
show_time_list
演出筛选列表
age_list
年龄筛选列表
destination_list
目的地筛选条件列表(只展示有活动的目的地)
app_tag_text
活动角标内容
destination_city_names
目的地
shop_name
场馆名称
cate_name
分类名称
tag_list
标签列表

正确返回示例

{

"show_time_list": [     //演出时间筛选项
    {
        "name": "不限",   //选项名称
        "show_time": "0"   //演出时间
    },
    {
        "name": "本周五",
        "show_time": "2015-11-27"
    },
    {
        "name": "本周六",
        "show_time": "2015-11-28"
    },
    {
        "name": "本周日",
        "show_time": "2015-11-29"
    },
    {
        "name": "下周五",
        "show_time": "2015-11-27"
    },
    {
        "name": "下周六",
        "show_time": "2015-11-28"
    },
    {
            "name": "下周日",
            "show_time": "2015-11-29"
    }
],
"age_list":[     //年龄筛选项
    {
        "name": "不限", //选项名称
        "age_min": "0",//最小
        "age_max": "0"//最大
    },
    {
        "name": "1-3岁",
        "age_min": "1",
        "age_max": "3"
    },
    {
        "name": "4-6岁",
        "age_min": "4",
        "age_max": "6"
    },
    {
        "name": "7-9岁",
        "age_min": "7",
        "age_max": "9"
    },
    {
        "name": "10-12岁",
        "age_min": "10",
        "age_max": "12"
    },
    {
            "name": "13岁及以上",
            "age_min": "13",
            "age_max": "0"
    }
],
    "cate_list": [
        {
            "cate_id": "25",
            "arrchildid": "25",
            "cate_name": "五星级酒店",
            "count": "36",
            "parentid": "45",
            "arrparentid": "0,45",
            "listorder": "1",
            "is_shield": "0"
        },
        {
            "cate_id": "40",
            "arrchildid": "40",
            "cate_name": "亲子旅行",
            "count": "10",
            "parentid": "45",
            "arrparentid": "0,45,40,45",
            "listorder": "0",
            "is_shield": "0"
        },
        {
            "cate_id": "41",
            "arrchildid": "41",
            "cate_name": "豪华邮轮",
            "count": "2",
            "parentid": "45",
            "arrparentid": "0,45",
            "listorder": "0",
            "is_shield": "1"
        },
        {
            "cate_id": "43",

        "destination_list": [       //目的地列表
        {
        "total": "2",    //目的地-省份包含的活动数量
        "name": "上海",  //目的地-省份名称
        "id": "9",//目的地-省份id
        "sub": [     //包含的市或区列表
            {

                "total": "2",   //目的地-市包含的活动
                "name": "黄浦区",  //目的地-市名称
                "id": "143" //目的的-事id

            },
            {

                "total": "1",
                "name": "普陀区",
                "id": "148"

            },...
        ]
    },...]

            "arrchildid": "43",
            "cate_name": "周边游",
            "count": "8",
            "parentid": "45",
            "arrparentid": "0,45",
            "listorder": "0",
            "is_shield": "0"
        }
    ],
    "cate_name": "家庭旅行",
    "cate_id": 45,
    "area_list": [
        {
            "area_id": "1",
            "area_name": "朝阳",
            "count": "12"
        },
        {
            "area_id": "2",
            "area_name": "海淀",
            "count": "2"
        },
        {
            "area_id": "5",
            "area_name": "崇文",
            "count": "1"
        },
        {
            "area_id": "11",
            "area_name": "昌平",
            "count": "1"
        },
        {
            "area_id": "13",
            "area_name": "顺义",
            "count": "1"
        },
        {
            "area_id": "15",
            "area_name": "怀柔",
            "count": "2"
        }
    ],
    "order_list": [
        {
            "name": "默认",
            "orderby": 0
        },
        {
            "name": "人气",
            "orderby": 1
        },
        {
            "name": "销量",
            "orderby": 2
        },
        {
            "name": "价格",
            "orderby": 3
        }
    ],
    "count": 69,
    "tuan_list": [
        {
            "ticket_group_id": "155", //票务id
            "aid": "9221",//活动id
            "ticket_type": "1",//活动类型
            "aid_name": "东方票务专用活动",//活动名称
            "sub_title": "",//副标题
            "aid_banner": "",//活动图片
            "aid_sell_num": "27",//已售
            "aid_start_time": "2014-05-22 10:58:00",//开始时间
            "aid_end_time": "2015-04-30 14:25:00",//结束时间
            "app_activity": "1",//活动类型:1普通2专享3特惠
            "min_market_price": "1",//市场价
            "min_goods_price": "1",//原价
            "is_official": 0,//是否是官方活动:1是0否

            "app_tag_text": "",//活动角标

            "destination_city_names": "西城区",//家庭旅行:目的地
            "shop_name": "",//场馆名称
            "cate_name": "",//分类名称
            "tag_list":
                {
                    "tag_name": "8"
                },
                {
                    "tag_name": "55"
                },
                {
                    "tag_name": "456456546"
                }
           

        },...
    ],
    "page": {
        "num": "69",
        "page": 1,
        "pagesize": 2
    }
}

错误返回示例

<source lang="php"> <error_code>100001</error_code> <error_msg>签名失败</error_msg> </source>