V2 0/other/index special recommand v32

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

功能说明

获取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>

示例代码