本文介绍在微信公众平台上如何使用高级接口开发用户分组接口的功能。 一、接口介绍 开发者可以使用接口,对公众平台的分组进行查询、创建、修改操作,也可以使用接口在需要时移动用户到某个分组。 一个公众账号,最多支持创建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"} 创建分组程序实现 $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); 执行结果如下: { "group": { "id": 100, "name": "老师" } } 查询所有分组 接口调用请求说明 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"} 程序实现: $url = "https://api.weixin.qq.com/cgi-bin/groups/get?access_token=$access_token"; $result = https_request($url); var_dump($result); 查询用户所在分组 通过用户的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"}