V1/activity/free activity list

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

功能说明

获取福利列表

URL

http://[域名]/v1/activity/free_activity_list

返回格式

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

HTTP请求方式

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

输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738
（1）公共参数
发送请求时必须传入公共参数，详见公共参数说明。
（2）私有参数
参数名称 是否必须 类型 描述
city_id 必须 int 城市id
c_id 必须 int 分类id
orderby 必须 int 排序 0默认 1按人气 2按发布时间
page 必须 int 页数
page_size 必须 int 每页个数

请求示例

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

排序规则

20150108-福利列表页面排序规则调整：报名中=即将开始〉报名结束

返回参数说明

参数 说明
aid 活动id
title 标题
sub_title 副标题
banner 图
start_time 活动开始时间
end_time 活动结束时间
aid_type 活动类型 1报名 2购买 3不能报名不能购买
apply_start_time 报名开始时间
apply_end_time 报名结束时间
people_num 可报名人数 0 为不限名额
apply_total 报名人数
min_market_price 最小超市价格
min_goods_price 最小商品价格
sell_num 已卖出数量
page 分页信息
count 总数
is_finish
 活动是否结束：0未结束，1结束
is_official
 官方活动：0否1是
shop_name
 场馆名称
tag_list
 标签列表

正确返回示例

<syntaxhighlight lang="xml">

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

<count>18</count>
 <page>
   <page>1</page>
   <page_size>1</page_size>
   <count>18</count>
 </page>
 <list>
   <item>
     <aid>100055</aid>
     <title>test测试活动11-免费试用</title>
     <sub_title/>
     <banner>http://img3.fumubang.net/huodong/banner/X20140619145755864.jpg</banner>
     <start_time>2014-06-21 14:56:00</start_time>
     <end_time>2014-08-31 09:53:00</end_time>
     <apply_start_time>2014-06-20 14:59:00</apply_start_time>
     <apply_end_time>2014-07-31 21:09:00</apply_end_time>
     <is_apply>1</is_apply>
     <is_sell>0</is_sell>
     <people_num>300</people_num>
     <apply_total>4</apply_total>
     <aid_type>1</aid_type>
     <is_finish>0</is_finish>
     <is_official>0</is_official>
      <tag_list>
            <item>
                <tag_name>双色球</tag_name>
            </item>
       </tag_list>
      <shop_name>joanna的小黑店连锁未标记地图</shop_name>
   </item>
 </list>
 <cate_list>
   <item>
     <category_id>34</category_id>
     <total>6</total>
     <category_name>周边农家乐</category_name>
   </item>
   <item>
     <category_id>36</category_id>
     <total>3</total>
     <category_name>打折特卖</category_name>
   </item>
   <item>
     <category_id>33</category_id>
     <total>3</total>
     <category_name>公益活动</category_name>
   </item>
   <item>
     <category_id>49</category_id>
     <total>2</total>
     <category_name>福利邦</category_name>
   </item>
   <item>
     <category_id>35</category_id>
     <total>1</total>
     <category_name>试听体验</category_name>
   </item>
   <item>
     <category_id>31</category_id>
     <total>1</total>
     <category_name>最in</category_name>
   </item>
   <item>
     <category_id>30</category_id>
     <total>1</total>
     <category_name>场馆1</category_name>
   </item>
   <item>
     <category_id>37</category_id>
     <total>1</total>
     <category_name>夏令营游学学</category_name>
   </item>
 </cate_list>

</syntaxhighlight>

错误返回示例

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

取自“http://wiki.fumubang.net/index.php?title=V1/activity/free_activity_list&oldid=5423”