获取拼团、助力活动的团员信息
<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&openid=OPENID&activity_token=TOKEN&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>