本文介绍在微信公众平台上如何使用高级接口开发用户分组接口的功能。
一、接口介绍
开发者可以使用接口，对公众平台的分组进行查询、创建、修改操作，也可以使用接口在需要时移动用户到某个分组。
一个公众账号，最多支持创建500个分组。 接口调用请求说明创建分组
http请求方式: POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKEN
POST数据格式：json
POST数据例子：{"group":{"name":"test"}}
参数说明
| 参数 | 说明 |
|---|---|
| access_token | 调用接口凭证 |
| name | 分组名字（30个字符以内） |
返回说明 正常时的返回JSON数据包示例：
{
"group": {
"id": 107,
"name": "test"
}
}
参数说明
| 参数 | 说明 |
|---|---|
| id | 分组id，由微信分配 |
| name | 分组名字，UTF8编码 |
错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}
查询所有分组
接口调用请求说明
http请求方式: GET（请使用https协议） https://api.weixin.qq.com/cgi-bin/groups/get?access_token=ACCESS_TOKEN
参数说明
| 参数 | 说明 |
|---|---|
| access_token | 调用接口凭证 |
返回说明 正常时的返回JSON数据包示例：
{
"groups": [
{
"id": 0,
"name": "未分组",
"count": 72596
},
{
"id": 1,
"name": "黑名单",
"count": 36
},
{
"id": 2,
"name": "星标组",
"count": 8
},
{
"id": 104,
"name": "华东媒",
"count": 4
},
{
"id": 106,
"name": "不测试组",
"count": 1
}
]
}
参数说明
| 参数 | 说明 |
|---|---|
| groups | 公众平台分组信息列表 |
| id | 分组id，由微信分配 |
| name | 分组名字，UTF8编码 |
| count | 分组内用户数量 |
错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}
查询用户所在分组
通过用户的OpenID查询其所在的GroupID。 接口调用请求说明
http请求方式: POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=ACCESS_TOKEN
POST数据格式：json
POST数据例子：{"openid":"od8XIjsmk6QdVTETa9jLtGWA6KBc"}
参数说明
| 参数 | 说明 |
|---|---|
| access_token | 调用接口凭证 |
| openid | 用户的OpenID |
返回说明 正常时的返回JSON数据包示例：
{
"groupid": 102
}
参数说明
| 参数 | 说明 |
|---|---|
| groupid | 用户所属的groupid |
错误时的JSON数据包示例（该示例为OpenID无效错误）：
{"errcode":40003,"errmsg":"invalid openid"}
修改分组名
接口调用请求说明
http请求方式: POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/groups/update?access_token=ACCESS_TOKEN
POST数据格式：json
POST数据例子：{"group":{"id":108,"name":"test2_modify2"}}
参数说明
| 参数 | 说明 |
|---|---|
| access_token | 调用接口凭证 |
| id | 分组id，由微信分配 |
| name | 分组名字（30个字符以内） |
返回说明 正常时的返回JSON数据包示例：
{"errcode": 0, "errmsg": "ok"}
错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}
移动用户分组
接口调用请求说明
http请求方式: POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=ACCESS_TOKEN
POST数据格式：json
POST数据例子：{"openid":"oDF3iYx0ro3_7jD4HFRDfrjdCM58","to_groupid":108}
参数说明
| 参数 | 说明 |
|---|---|
| access_token | 调用接口凭证 |
| openid | 用户唯一标识符 |
| to_groupid | 分组id |
返回说明 正常时的返回JSON数据包示例：
{"errcode": 0, "errmsg": "ok"}
错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}
二、程序实现
创建分组
$access_token = ""; $data = ‘{"group": {"name": "老师"}}‘; $url = "https://api.weixin.qq.com/cgi-bin/groups/create?access_token=$access_token"; $result = https_request($url, $data); $jsoninfo = json_decode($result, true); var_dump($result); function https_request($url, $data = null) { $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); if (!empty($data)){ curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, $data); } curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); $output = curl_exec($curl); curl_close($curl); return $output; }
执行结果如下：
{
"group": { "id": 100, "name": "老师" } }
其他分组方法实现类似，只需要更改$data 及$url即可。
====================================================================
方倍工作室微信公众平台账号关注方法：
1. 微信通讯录-添加朋友-查找公众号-搜索“方倍工作室”
2. 微信通讯录-添加朋友-搜号码-输入“pondbaystudio”
3. 使用微信扫描下面的二维码
微信公众平台开发(88) 用户分组接口,码迷,mamicode.com