V1/activity/get list info

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

功能说明

获取活动列表数据

URL

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

返回格式

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

HTTP请求方式

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

输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738
（1）公共参数
发送请求时必须传入公共参数，详见公共参数说明。
（2）私有参数
参数名称 是否必须 类型 描述
city_id 否 int 城市id
category_id 否 int 活动类型id
area_id 否 int 区域id
business_id 否 int 商圈id
datatype 否 int 取数据方式：1:取报名的;2:取可购买的;3:取报名和购买的;默认是0:取全部活动
orderby 否 int 排序方式:1:结束时间;2开始时间，3:报名时间
page 否 int 页码,从1开始
pagesize 否 int 每页大小

请求示例

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

返回参数说明

参数 说明
list 活动列表数据
page 分页信息
category_num 分类信息
ac_area_num 区域信息
order_list 排序信息

正确返回示例

<syntaxhighlight lang="xml">

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

 <list>
   <list36>
     <aid>36</aid>
     <title>十八渡乐园</title>
     <banner>http://img3.fumubang.net/huodong/6/1687e4e5ea7df25785b927e5de13ec83.jpg</banner>
     <start_time>2013-01-01 00:00:00</start_time>
     <end_time>2013-09-30 17:57:00</end_time>
     <recommend>1</recommend>
     <area_id>1</area_id>
     <business_id>0</business_id>
     <category_id>34</category_id>
     <sell_num>0</sell_num>
     <is_apply>0</is_apply>
     <is_sell>0</is_sell>
     <apply_total>0</apply_total>
<content>

十八渡乐园景点介绍


十八渡乐园位于国家4A级景区十渡与国家5A级景区野三坡之间，毗邻东湖港风景区，前临拒马河，背靠五指山，风光景色秀美，是当地规模和人气数一数二的农家乐。

<img src="http://img3.fumubang.net/huodong/6/9f8380775c1688f01165734fa7a92c8d.jpg" />


十八渡乐园主要经营自助烧、十渡地方菜和住宿还有KTV、台球、钓鱼、麻将等等众多娱乐项目。

<img src="http://img3.fumubang.net/huodong/6/70c34731a15d53c0a614b47132f0e70e.jpg" />


乐园有客房二十余间，可供70人同时住宿，园内有超大停车场，可供百余车辆免费停车。河边还种有千余棵杨树，是野钓、吊床和户外烧烤的绝佳之地。另外园内还散养有山羊、野兔、虹鳟鱼、柴鸡等等可供现场宰杀，肉质鲜美无比！

<img src="http://img3.fumubang.net/huodong/6/af7454635f291b4d5686a2210ced9e2d.jpg" />


<img src="http://img3.fumubang.net/huodong/6/fa55c984535404cd444266c539505437.jpg" />


</content> 
   </list36>
   <list1098>
     <aid>1098</aid>
     <title>汉光百货 美妆周会员礼</title>
     <banner>http://img3.fumubang.net/huodong/X20130829171917367.jpg</banner>
     <start_time>2014-02-01 10:48:00</start_time>
     <end_time>2014-08-18 10:49:00</end_time>
     <recommend>1</recommend>
     <area_id>0</area_id>
     <business_id>0</business_id>
     <category_id>36</category_id>
     <sell_num>9</sell_num>
     <is_apply>0</is_apply>
     <is_sell>1</is_sell>
     <apply_total>0</apply_total>
<content>

9月未到，汉光美妆周已经开幕，美丽会员礼可以提前享！8月30日—9月1日汉光会员在化妆品、药妆品区现金类当日消费满1500元可获赠“欧莱雅洗护套装”一份，秀发也要防秋燥！（记得在付款时出示汉光会员卡哦）
<img src="http://img2.55bbs.com/shopping/ck/1377766166.jpg" style="width:650px;height:917px;" />

</content> 
   </list1098>
 </list>
 <page>
   <num>986</num>
   <page>1</page>
   <pagesize>2</pagesize>
 </page>
 <category_num>
   <item>
     <category_id>32</category_id>
     <total>140</total>
     <category_name>演出票务</category_name>
   </item>
   <item>
     <category_id>36</category_id>
     <total>137</total>
     <category_name>打折特卖</category_name>
   </item>
   <item>
     <category_id>37</category_id>
     <total>135</total>
     <category_name>夏令营游学学</category_name>
   </item>
   <item>
     <category_id>30</category_id>
     <total>122</total>
     <category_name>场馆1</category_name>
   </item>
   <item>
     <category_id>35</category_id>
     <total>100</total>
     <category_name>试听体验</category_name>
   </item>
   <item>
     <category_id>34</category_id>
     <total>100</total>
     <category_name>周边农家乐</category_name>
   </item>
   <item>
     <category_id>31</category_id>
     <total>59</total>
     <category_name>最in</category_name>
   </item>
   <item>
     <category_id>28</category_id>
     <total>49</total>
     <category_name>景点门票</category_name>
   </item>
   <item>
     <category_id>39</category_id>
     <total>48</total>
     <category_name>亲子邮轮</category_name>
   </item>
   <item>
     <category_id>33</category_id>
     <total>46</total>
     <category_name>公益活动</category_name>
   </item>
   <item>
     <category_id>38</category_id>
     <total>34</total>
     <category_name>展览讲座</category_name>
   </item>
   <item>
     <category_id>40</category_id>
     <total>11</total>
     <category_name>旅行优惠</category_name>
   </item>
   <item>
     <category_id>47</category_id>
     <total>2</total>
     <category_name>全国活动</category_name>
   </item>
   <item>
     <category_id>43</category_id>
     <total>2</total>
     <category_name>海外游学/冬令营</category_name>
   </item>
 </category_num>
 <ac_area_num>
   <item>
     <area_id>1</area_id>
     <total>121</total>
     <area_name>朝阳</area_name>
   </item>
   <item>
     <area_id>24</area_id>
     <total>79</total>
     <area_name>浦东新区</area_name>
   </item>
   <item>
     <area_id>23</area_id>
     <total>64</total>
     <area_name>徐汇区</area_name>
   </item>
   <item>
     <area_id>4</area_id>
     <total>41</total>
     <area_name>西城</area_name>
   </item>
   <item>
     <area_id>3</area_id>
     <total>40</total>
     <area_name>东城</area_name>
   </item>
   <item>
     <area_id>2</area_id>
     <total>38</total>
     <area_name>海淀</area_name>
   </item>
   <item>
     <area_id>22</area_id>
     <total>37</total>
     <area_name>静安区</area_name>
   </item>
   <item>
     <area_id>20</area_id>
     <total>24</total>
     <area_name>黄浦区</area_name>
   </item>
   <item>
     <area_id>30</area_id>
     <total>15</total>
     <area_name>闵行区</area_name>
   </item>
   <item>
     <area_id>26</area_id>
     <total>15</total>
     <area_name>虹口区</area_name>
   </item>
   <item>
     <area_id>25</area_id>
     <total>13</total>
     <area_name>长宁区</area_name>
   </item>
   <item>
     <area_id>29</area_id>
     <total>12</total>
     <area_name>闸北区</area_name>
   </item>
   <item>
     <area_id>21</area_id>
     <total>12</total>
     <area_name>卢湾区</area_name>
   </item>
   <item>
     <area_id>31</area_id>
     <total>11</total>
     <area_name>宝山区</area_name>
   </item>
   <item>
     <area_id>36</area_id>
     <total>10</total>
     <area_name>崇明县</area_name>
   </item>
   <item>
     <area_id>7</area_id>
     <total>9</total>
     <area_name>丰台</area_name>
   </item>
   <item>
     <area_id>32</area_id>
     <total>9</total>
     <area_name>嘉定区</area_name>
   </item>
   <item>
     <area_id>34</area_id>
     <total>9</total>
     <area_name>奉贤区</area_name>
   </item>
   <item>
     <area_id>38</area_id>
     <total>8</total>
     <area_name>松江区</area_name>
   </item>
   <item>
     <area_id>28</area_id>
     <total>8</total>
     <area_name>普陀区</area_name>
   </item>
   <item>
     <area_id>27</area_id>
     <total>7</total>
     <area_name>杨浦区</area_name>
   </item>
   <item>
     <area_id>33</area_id>
     <total>7</total>
     <area_name>青浦区</area_name>
   </item>
   <item>
     <area_id>15</area_id>
     <total>5</total>
     <area_name>怀柔</area_name>
   </item>
   <item>
     <area_id>11</area_id>
     <total>4</total>
     <area_name>昌平</area_name>
   </item>
   <item>
     <area_id>39</area_id>
     <total>3</total>
     <area_name>上海周边</area_name>
   </item>
   <item>
     <area_id>37</area_id>
     <total>3</total>
     <area_name>金山区</area_name>
   </item>
   <item>
     <area_id>13</area_id>
     <total>3</total>
     <area_name>顺义</area_name>
   </item>
   <item>
     <area_id>12</area_id>
     <total>3</total>
     <area_name>大兴</area_name>
   </item>
   <item>
     <area_id>10</area_id>
     <total>2</total>
     <area_name>房山</area_name>
   </item>
   <item>
     <area_id>8</area_id>
     <total>2</total>
     <area_name>通州</area_name>
   </item>
   <item>
     <area_id>16</area_id>
     <total>2</total>
     <area_name>延庆</area_name>
   </item>
   <item>
     <area_id>9</area_id>
     <total>2</total>
     <area_name>石景山</area_name>
   </item>
   <item>
     <area_id>14</area_id>
     <total>2</total>
     <area_name>密云</area_name>
   </item>
   <item>
     <area_id>19</area_id>
     <total>1</total>
     <area_name>北京周边</area_name>
   </item>
   <item>
     <area_id>56</area_id>
     <total>1</total>
     <area_name/>
   </item>
   <item>
     <area_id>35</area_id>
     <total>1</total>
     <area_name>南汇区</area_name>
   </item>
   <item>
     <area_id>6</area_id>
     <total>1</total>
     <area_name>宣武</area_name>
   </item>
   <item>
     <area_id>17</area_id>
     <total>1</total>
     <area_name>平谷</area_name>
   </item>
 </ac_area_num>
 <order_list>
   <item>
     <name>默认</name>
     <orderby>0</orderby>
   </item>
   <item>
     <name>结束</name>
     <orderby>1</orderby>
   </item>
   <item>
     <name>开始</name>
     <orderby>2</orderby>
   </item>
   <item>
     <name>报名</name>
     <orderby>3</orderby>
   </item>
 </order_list>


</syntaxhighlight>

错误返回示例

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

示例代码

<syntaxhighlight lang="php"> <?php 

       //生成签名
function verification($arr,$appkey){
           //过虑生成新的数组
    $para_filter = array();
    foreach ($arr as $key => $val ) {
if( in_array($key,array('sign','appid','imgupload')) || $val == "")continue;
else $para_filter[$key] = $arr[$key];
    }
   //排序数组
   ksort($para_filter);
   reset($para_filter);

   //再把所有数组值以“&”字符连接起来
   $arg  = "";
   foreach ($para_filter as $key => $val ) {
       $arg.=$key."=".urlencode($val)."&";
   }

   //去掉最后一个&字符
   $arg = substr($arg,0,count($arg)-2);

          //如果存在转义字符，那么去掉转义
   if(get_magic_quotes_gpc()){$arg = stripslashes($arg);}
   $prestr = $arg . $appkey;

          return md5($prestr); 

}

//访问api
function post_api($api_url,$data){
    $ch = curl_init();
           curl_setopt($ch, CURLOPT_URL, $api_url);
           curl_setopt($ch, CURLOPT_POST, 1); 
           curl_setopt($ch, CURLOPT_CONNECTTIMEOUT,3000);
           curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
           curl_setopt($ch, CURLOPT_POSTFIELDS, $data); 
           $ret = curl_exec($ch);
           curl_close($ch);
    return $ret;
       }
   

$api_url = "http://api.fumubang.net/v1/activity/get_list_info?format=json";

$post_field = array('city_id'=>1,'appid'=>'638481987');
$sign = verification($post_field,'f47daca46b0257cee674bf15a8fdc063');
$post_field['sign'] = $sign;


$result = post_api($api_url,json_encode($post_field));
$ret = json_decode($result,true);

var_dump($ret);

?> </syntaxhighlight>

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