官方接口 - 用户管理

用户分组 - 创建分组

调用方法:.create_group(name)

参数:

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据:

{
    "group": {
        "id": 107, 
        "name": "test"
    }
}

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:创建分组

用户分组 - 查询所有分组

调用方法:.get_groups()

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 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
        }
    ]
}

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:查询所有分组

用户分组 - 查询用户所在分组

调用方法:.get_group_by_id(openid)

参数:

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据:

{
    "groupid": 102
}

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:查询用户所在分组

用户分组 - 修改分组名

调用方法:.update_group(group_id, name)

参数:

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据:

{
    "errcode": 0, 
    "errmsg": "ok"
}

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:修改分组名

用户分组 - 移动用户分组

调用方法:.move_user(user_id, group_id)

参数:

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据:

{
    "errcode": 0, 
    "errmsg": "ok"
}

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:移动用户分组

用户分组 - 批量移动用户分组

待开发

用户分组 - 删除分组

待开发

设置用户备注名

待开发

获取用户基本信息

调用方法:.get_user_info(user_id, lang='zh_CN')

参数:

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据:

{
    "subscribe": 1, 
    "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M", 
    "nickname": "Band", 
    "sex": 1, 
    "language": "zh_CN", 
    "city": "广州", 
    "province": "广东", 
    "country": "中国", 
    "headimgurl": "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0", 
    "subscribe_time": 1382694957,
    "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL",
    "remark": "",
    "groupid": 0
}

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:获取用户基本信息

批量获取用户基本信息

待开发

获取用户列表

调用方法:.get_followers(first_user_id=None)

参数:

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据:

{
    "total": 2,
    "count": 2,
    "data":
    {
        "openid":
        [
            "",
            "OPENID1",
            "OPENID2"
        ]
    },
    "next_openid": "NEXT_OPENID"
}

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:获取用户列表

获取用户地理位置

待开发