活动盒子对外接口

活动盒子对外接口


获取拼团、助力活动的团员信息

<p><strong>简要描述:</strong> </p> <ul> <li>获取拼团类、助力类活动中团队成员的相关信息</li> </ul> <p><strong>接口域名: </strong></p> <ul> <li><code>https://data.huodonghezi.com</code></li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>/group-members?mobile=MOBILE&amp;openid=OPENID&amp;activity_token=TOKEN&amp;access_token=ACCESS_TOKEN</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li><code>GET</code> </li> </ul> <p><strong>参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">mobile</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>手机号,当传入手机号时,返回指定手机号的相关数据,不传入时,返回活动所有数据</td> </tr> <tr> <td style="text-align: left;">openid</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>微信openid 当传入时,返回相关openid用户的内容</td> </tr> <tr> <td style="text-align: left;">per_page</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>每一页的条数,最大是200 ,不填时默认为20条每页</td> </tr> <tr> <td style="text-align: left;">page</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>当前页码,不填是默认为1</td> </tr> <tr> <td style="text-align: left;">activity_token</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>活动token,不传则返回所有相关活动的数据</td> </tr> <tr> <td style="text-align: left;">access_token</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>access_token的获取请看【<a href="http://www.showdoc.cc/8513?page_id=65120" title="获取ACCESS_TOKEN">获取ACCESS_TOKEN</a>】接口</td> </tr> </tbody> </table> <p><strong>返回示例</strong></p> <pre><code>{ "error_code": 0, "error_msg": "SUCCESS", "data": [ { "activity_token":"act-xxxx",//活动token(活动唯一标识) "group_id":1,//团id(团唯一标识) "group_name":"团名称",//团名称 "members":[ { //团长在应用内参与抽奖,所以没有绑定手机号的流程,只返回用户唯一标识,开发者可以通过username查找自己的系统对应的用户 "is_commander":1,//1表示是团长,0表示是团员 "username":"xxxxxx",//用户唯一标识 "detail":{ "username":"xxxxx", "mobile":"xxx", ...//app触发的时候传的其他属性 } }, { "is_commander":0,//1表示是团长,0表示是团员 "mobile":"138xxxxx",//手机号 "openid":"xxxxxx",//微信openid "detail":{//微信用户信息,可参考微信相关文档 "city": "广州" "country": "中国" "headimgurl": "http://thirdwx.qlogo.cn/xxx" "language": "zh_CN" "nickname": "HL" "openid": "xxxx" "privilege": [] "province": "广东" "sex": 2 } } ... ] }, ... ], "pagination":{ "per_page":"2",//每页数量 "current_page":1,//当前页 "total":20,//总数 "last_page":10//最后一页(总页数) } }</code></pre> <p><strong>返回参数说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">activity_token</td> <td style="text-align: left;">string</td> <td>活动token</td> </tr> <tr> <td style="text-align: left;">group_id</td> <td style="text-align: left;">int</td> <td>团id</td> </tr> <tr> <td style="text-align: left;">group_name</td> <td style="text-align: left;">string</td> <td>团名</td> </tr> <tr> <td style="text-align: left;">members</td> <td style="text-align: left;">object</td> <td>团成员</td> </tr> <tr> <td style="text-align: left;">is_commander</td> <td style="text-align: left;">int</td> <td>是否是团长。1表示是团长,0表示是团员</td> </tr> <tr> <td style="text-align: left;">username</td> <td style="text-align: left;">string</td> <td>应用内用户唯一标识</td> </tr> <tr> <td style="text-align: left;">openid</td> <td style="text-align: left;">string</td> <td>微信openid</td> </tr> <tr> <td style="text-align: left;">mobile</td> <td style="text-align: left;">string</td> <td>手机号</td> </tr> <tr> <td style="text-align: left;">detail</td> <td style="text-align: left;">object</td> <td>用户详情,app用户和微信用户的详情,具体内容不一样</td> </tr> </tbody> </table> <p><strong>备注</strong></p> <ul> <li>更多返回错误代码请看【<a href="http://www.showdoc.cc/8513?page_id=64989" title="全局返回码">全局返回码</a>】</li> </ul>

页面列表

ITEM_HTML