诺云开放平台

Appearance

用户列表 ​

历史版本 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/User/getWechatUserList/2.0.0
  • 频率限制：10秒1000次

请求参数 ​

参数必选类型描述
page是integer页码，从1开始
page_size是integer每页条数，最大500
last_visit_start否integer最后访问起始时间(包含当前时间)
last_visit_end否integer最后访问结束时间(包含当前时间)
wechat_user_space_id否integer搜索的用户id
time_st否integer用户更新时间 - 开始（时间戳）
time_et否integer用户更新时间 - 结始（时间戳）
last_id否integer分页游标（上一页的最后一条数据id）
wechat_user_space_ids否array批量查询用户ID列表，最多300个
sort_order否string排序方式：asc（升序）、desc（降序），默认 desc，按用户关系记录ID排序

请求示例 ​

json
{
    "page": 1,
    "page_size": 20,
    "last_visit_start": 1704067200,
    "last_visit_end": 1706745599,
    "wechat_user_space_id": 0,
    "time_st": 1704067200,
    "time_et": 1706745599,
    "wechat_user_space_ids": [1001234, 1001235],
    "sort_order": "desc"
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
data是object消息内容

data 参数结构

参数必选类型描述
total是integer总记录数
list是array用户列表

list 参数结构

参数必选类型描述
wechat_user_space_id是integer用户ID
shut_up是integer禁言：0-无，1-全部
forbid是integer拉黑：0-无，1-全部
shield是integer屏蔽：0-无，1-全部
first_visit_time是integer首次访问时间
last_visit_time是integer最近访问时间
openid是stringopenid
unionid是stringunionid
name是string用户昵称
photo是string用户头像
last_mobile是string最近采集用户电话号码
third_uuid否string三方系统用户id
user_create_time否string用户创建时间
user_update_time否string用户更新时间
id是integer数据id(可当做下一页的游标)
third_wechat_info是object第三方微信信息

third_wechat_info 参数结构

参数必选类型描述
authorizer_appid是string第三方公众号appid
openid是string第三方openid
unionid是string第三方unionid

响应示例 ​

json
{
    "code": 200,
    "data": {
        "list": [
            {
                "wechat_user_space_id": 1001234,
                "shut_up": 0,
                "forbid": 0,
                "shield": 0,
                "first_visit_time": 1704067200,
                "last_visit_time": 1706745599,
                "openid": "oKFTf0ZA1JAo8qw65AgYva4A5irM",
                "unionid": "o8-ysv_an9GvERIlh8kYn5SwwsX8",
                "name": "张三",
                "photo": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTKxrqXeFicQ55Q/132",
                "last_mobile": "138****1234",
                "third_uuid": "user_001",
                "third_wechat_info": {
                    "authorizer_appid": "wx1234567890abcdef",
                    "openid": "oKFTf0ZA1JAo8qw65AgYva4A5irM",
                    "unionid": "o8-ysv_an9GvERIlh8kYn5SwwsX8"
                },
                "user_create_time": "2024-01-01 10:30:00",
                "user_update_time": "2024-01-31 15:45:30",
                "id": 57513354
            },
            {
                "wechat_user_space_id": 1001235,
                "shut_up": 1,
                "forbid": 0,
                "shield": 0,
                "first_visit_time": 1704153600,
                "last_visit_time": 1706659200,
                "openid": "oKFTf0ZA1JAo8qw65AgYva4A5irN",
                "unionid": "o8-ysv_an9GvERIlh8kYn5SwwsX9",
                "name": "李四",
                "photo": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTKxrqXeFicQ55R/132",
                "last_mobile": "139****5678",
                "third_uuid": "user_002",
                "third_wechat_info": {
                    "authorizer_appid": "wx1234567890abcdef",
                    "openid": "oKFTf0ZA1JAo8qw65AgYva4A5irN",
                    "unionid": "o8-ysv_an9GvERIlh8kYn5SwwsX9"
                },
                "user_create_time": "2024-01-02 14:20:15",
                "user_update_time": "2024-01-30 09:15:45",
                "id": 57513355
            }
        ],
        "total": 156
    },
    "msg": "Success"
}