获取成员手机号

使用场景： 根据userid来查询用户手机号。

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/user/phone/get?access_token=ACCESS_TOKEN&userid=USERID

参数说明：

注意：access_token，可以使用用户票据access_token代替（由/open/access_token获得。） 此时userid可以不传，由用户本身userid确定。

返回示例：

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

参数说明：

修改成员手机号

使用场景： 更新一个用户的手机号，用于用户换绑手机，或者收集到手机号发生变化。

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/common/user/update_mobile

Query参数:

Body参数：

返回参数：

请求示例

POST https://oapi.epaas.qq.com/common/user/update_mobile?access_token=ACCESS_TOKEN

请求包体：

{
  "userid": "3",
  "mobile": "18888888888",
  "single_identity": true
}

返回示例：

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

批量获取成员手机号

使用场景： 根据userid来批量查询用户手机号。

权限说明

请求方式： GET, POST （HTTPS）

请求地址： https://oapi.epaas.qq.com/user/phone/batch_get?access_token=ACCESS_TOKEN

请求包体：

{
    "userids": [
        "123",
        "456"
    ]
}

参数说明：

返回示例：

{
    "errmsg": "ok",
    "errcode": 0,
    "userlist": [
        {
            "userid": "30009907",
            "phone": ""
        }
    ]
}

参数说明：

按手机号检索成员

使用场景： 根据phone来查询用户。

权限说明

请求地址: https://oapi.epaas.qq.com/common/user/search_by_phone

请求方法: POST

请求包体：

{
  "phone":"18682451723",
  "role_ids":[12,13],
  "fetch_child":0,
  "sub_corpids":[1004820,1086786]
}

请求参数:

返回示例：

{
    "errmsg": "ok",
    "errcode": 0,
    "user_list": [
        {
            "userid": "3723911489",
            "name": "张三",
            "role_id": 12,
            "corp_id": 1086786,
            "corp_name": "测试学校",
            "corp_type": 4
        }
    ]
}

参数说明:

批量按手机号检索成员

使用场景： 批量按手机号检索成员。

权限说明

请求地址: https://oapi.epaas.qq.com/common/user/batch_search_by_phone

请求方法: POST

请求包体：

{
  "phone": ["18682451723"],
  "role_ids": [12],
  "fetch_child":0,
  "sub_corpids":[1004820,1086786]
}

请求参数:

返回示例：

{
    "errmsg": "ok",
    "errcode": 0,
    "user_list": [
        {
            "phone": "18682451723",
            "userid": "3723911489",
            "name": "张三",
            "role_id": 12,
            "corp_id": 1086786,
            "corp_name": "测试学校",
            "corp_type": 4
        },
        {
            "phone": "18682451723",
            "userid": "3723911489",
            "name": "张三",
            "role_id": 13,
            "corp_id": 1086786,
            "corp_name": "测试学校",
            "corp_type": 4
        }
    ]
}

参数说明:

批量设置手机号

使用场景： 使用userid批量设置手机号。

权限说明

请求方式： POST （HTTPS）

请求地址： https://oapi.epaas.qq.com/common/user/batch_set_phone?access_token=ACCESS_TOKEN

请求包体：

{
    "set_phones": [
        {
            "userid": "3724690177",
            "phone": "18682451723"
        }
    ]
}

参数说明：

返回示例：

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

参数说明：