zoukankan      html  css  js  c++  java
  • 微信公众平台开发(88) 用户分组接口

    本文介绍在微信公众平台上如何使用高级接口开发用户分组接口的功能。

    一、接口介绍

    开发者可以使用接口,对公众平台的分组进行查询、创建、修改操作,也可以使用接口在需要时移动用户到某个分组。


    一个公众账号,最多支持创建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"}

     

    ====================================================================

    方倍工作室微信公众平台账号关注方法:
    1. 微信通讯录-添加朋友-查找公众号-搜索“方倍工作室”
    2. 微信通讯录-添加朋友-搜号码-输入“pondbaystudio”
    3. 使用微信扫描下面的二维码

  • 相关阅读:
    移动 App 接入 QQ 登录/分享 图文教程
    Word 最后一页无法删除-解决办法
    Java快速入门-04-Java.util包简单总结
    Java快速入门-03-小知识汇总篇(全)
    SSM 框架-06-详细整合教程(IDEA版)(Spring+SpringMVC+MyBatis)
    二叉树的镜像
    浅析I/O模型及其设计模式
    远程方法调用(RMI)原理与示例
    树的子结构
    合并两个排序的链表
  • 原文地址:https://www.cnblogs.com/lanzhi/p/6467500.html
Copyright © 2011-2022 走看看