V2 0/other/index special recommand v32
目录
功能说明
获取APP首页推荐数据(类别,活动) 本接口是全平台通用的,即发送请求后,可根据请求中传入的"city_id"平台参数返回发送状态。
例如:如果传入的city_id = 1,返回北京的数据等,支持V3.2及以上版本客户端
URL
正式环境 http://api.fumubang.com/v2_0/other/index_special_recommend_v32 测试环境 http://api.fumubang.net/v2_0/other/index_special_recommend_v32
格式
json
HTTP请求方式
POST
输入参数说明
uid = xxxxxxxx 用户UID
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
city_id | 是 | int | 以json格式POST传入,城市ID |
uid |
否 |
string |
2.1以后版本加入 |
version |
是 |
string |
版本号 |
opversion |
是 |
string |
手机系统版本 |
apk_channel |
否 |
string |
下载渠道,android客户端必传(3.02以上版本适用) |
请求示例
http://api.fumubang.com/v1/other/index_special_recommend_v32
openid=xxxxxxx 父母邦分配
openkey=xxxxxxxx 父母邦分配
city_id = xxxxxxxx 城市ID
参数用POST方式提交
返回方式说明
xml或json
数据显示规则调整
20150109 按照后台原始设置显示,首页精彩推荐,取消删除售罄规则
{
"activity_type": [ //导航数据
{
"name": "亲子活动",
"categoryimage": "http://img2.fumubang.net/tpl_imgpath/activity_type/X2016031011160074.png!thumb_320_320",
"sortindex": "1",
"is_tuan": "1", ////类型:1为分类列表;3为标签列表;4为周边游;5为长途游
"category_id": "36",
"activity_tag": "", //标签
"tag_title": "", //标签标题
"level": 1,
"cate_name": "会员福利",
"parent_name": "五星级酒店",
"parentid": "0"
},
...
],
"activity_recommend": [ //后台推荐的活动
{
"aid": "2000215",
"sortindex": "10", //排序,已经排列好了,越大越靠前
"type": "1",
"destination_city_names": "北辰区", //目的地
"shop_name": "", //剧场名称
"cate_name": "", //分类名称
"aid_name": "joanna-两天一夜幸福村自由行",
"app_activity": null,
"sub_title": "农家乐乐乐乐乐",
"aid_banner": "http://img3.fumubang.net/test/D20160314150520868.jpg",
"aid_sell_num": "14",
"aid_people_num": 0,
"aid_type": 1, //类型 1 报名 2 购买 3 不能购买不能报名
"is_sell": "1", //是否可购买:0:不可购买
"is_apply": "0", //是否可报名:0:不可报名
"min_market_price": "", //市场价起
"min_goods_price": "674.50", //销售价起
"tag_list": [ //标签列表,返回5个
{
"tag_name": "自由行"
},
{
"tag_name": "双色球"
}
],
"app_tag_text": ""//列表角标
},
...
],
"activity_new": [ //按最新上架的活动,返回20条
{
"aid": "102457",
"aid_name": "lytest——酒+景活动",
"sub_title": "酒+景活动",
"aid_banner": "http://img3.fumubang.net/huodong/banner/X20151211102755901.jpg",
"start_time": "0000-00-00 00:00:00",
"end_time": "0000-00-00 00:00:00",
"aid_people_num": "0",
"aid_sell_num": "0",
"is_sell": "1",
"is_apply": "0",
"min_goods_price": "60.00",
"min_market_price": "120",
"app_activity": "1",
"destination_city_names": "廊坊市",
"shop_name": "",
"cate_name": "",
"tag_list": [],
"aid_type": 2,
"is_official": 0,
"apply_total": 0,
"is_sell_apply_show": null,
"ticket_type": null,
"type": "",
"sortindex": "",
"app_tag_text": ""//列表角标
},
...
],
"activity_hot": [ //近一个月内销量由高到低的活动,返回20条
{
"aid": "100611",
"aid_name": "宣武 自贡 shuwen测试活动----l----酒店哦oooooo ",
"sub_title": "这里是副标题啦iii",
"aid_banner": "http://img3.fumubang.net/huodong/banner/X20160822153533286.jpg",
"start_time": "2015-03-04 17:59:00",
"end_time": "2016-01-31 14:35:00",
"aid_people_num": "0",
"aid_sell_num": "419",
"is_sell": "1",
"is_apply": "0",
"min_goods_price": "1.00",
"min_market_price": "10",
"app_activity": "1",
"order_sell_num": "4",
"destination_city_names": "宣武区,自贡市",
"shop_name": "",
"cate_name": "",
"tag_list": [
{
"tag_name": "酒店"
},
{
"tag_name": "天津"
},
{
"tag_name": "兰州"
}
],
"aid_type": 2,
"is_official": 0,
"apply_total": 0,
"is_sell_apply_show": null,
"ticket_type": null,
"type": "",
"sortindex": "",
"app_tag_text": ""//列表角标
},
...
],
"banner": [ //轮播图
{
"banner_id": "", //主题或活动id
"type": "2", //类型: 1活动 2 主题
"bannerapp": "http://img2.fumubang.net/tpl_imgpath/banner/X20151218180141572.jpg", //图片地址
"sortindex": "11",
"pageurl": "http://m.fumubang.net/mobile/subject/s20150914?is_app=1", //专题链接地址
"title": "专题", //标题
"banner": "http://img2.fumubang.net/tpl_imgpath/banner/X20151218180141572.jpg"
},
...
],
"index_recommand": [ //首页推荐栏列表
{
"rid": "4441",
"title": "自定义列表", //标题
"description": "测试", //描述
"page_url": "", //页面地址
"show_index": "1", //排序
"image_path": "http://img2.fumubang.net/tpl_imgpath/app_index_recommand/X20160818111938973.png!thumb_640", //排序地址
"type": "6", //推荐类型:1专题,2文章,3活动,4福利,5标签列表,6自定义列表
"activity_id": "0", //活动id
"article_id": "0", //文章id
"city_id": "2", //城市:1北京2商户
"activity_tag": "", //活动标签
"tag_list_title": "结伴er出游", //标签列表标题
"action_name": "partner" //自定也列表名称
},...
],
"more_activity": 2, //APP首页更多活动类型 类型 1=活动 2=演出 3=精品 4=旅游
"show_qq": "on", //便于ios在app store审核,on开启qq登录,off关闭qq登录(1.6版本以上返回此字段)
"kefu_activityDetail": "false", //设置页开关是否开启客服:true开启,false关闭
"kefu_myConfig": "false", //设置页开关是否开启客服:true开启,false关闭
"kefu_orderDetail": "false", //订单详情是否开启客服:true开启,false关闭。
"update_version_info": {
"update_version": "2.10#2.20#2.30#2.40#2.50#3.02",
"update_normal_desc": "非强制更新提示内容",
"update_force_desc": "强制更新提示内容"
},
"pay_channel": {
"weixin": "on",
"alipay": "on",
"unionpay": "on"
},
"android_apk": {
"apk_channel": "360", //渠道
"version": "3.0", //版本号
"apk_url": "http://img3.fumubang.net/app/android20160729176374.apk", //下载路径
"apk_md5": "8f346eb9b267a7b249813eb1a96a5eef", //apk的md5
"apk_size": "10718632"//apk的size
"update_normal_desc": "非强制升级3.04", //非强制升级描述
"update_force_desc": "强制升级3.04" //强制升级描述
},
"have_new_message": 2 //消息条数 0为没有新消息 3.35版本及以上添加
}
"hot_scenic": [
{
"title": "尖沙咀",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122085932254.png",
"type": 1
},
{
"title": "夜上海",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122132641538.png",
"type": 1
},
{
"title": "百乐门",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122132659136.png",
"type": 1
},
{
"title": "火星情报局",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122132731998.png",
"type": 1
},
{
"title": "东方明珠",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122132805141.png",
"type": 1
},
{
"title": "月亮湾",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122132852692.png",
"type": 1
},
{
"title": "龙塔",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122132910740.png",
"type": 1
},
{
"title": "太阳岛",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122133052253.png",
"type": 1
},
{
"title": "上海滩",
"img_url": "http://img2.fumubang.net/tpl_imgpath/hot_scenic/X20161122115931993.png",
"type": 1
}
],
"hot_destination":
[
{
"title": "北京",
"type": 1
},
{
"title": "广州",
"type": 1
},
{
"title": "深圳",
"type": 1
},
{
"title": "上海",
"type": 1
},
{
"title": "伊春",
"type": 1
}
]
注:
三个推荐列表显示:
酒店增加, 目地的、标签的展示;
演出增加活动时间、商户名称、标签展示;
活动、购物、报名增加 二级分类名称、标签展示;
错误返回示例
参数不全
<error_code>300000</error_code> <error_msg> 参数不全 </error_msg>