诺云开放平台

Appearance

门店用户列表 ​

请求路径 ​

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

请求参数 ​

参数必选类型描述
page是integer页码，从1开始
page_size是integer每页条数。最大300
name否string用户名称模糊搜索
mobile否string用户手机号模糊搜索
wechat_user_space_id否integer微信用户空间id
sale_name否string销售员名称模糊搜索
market_channel否string门店名称模糊搜索
manager_name否string管理员名称模糊搜索
start_time否string开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time否string结束时间，格式：yyyy-MM-dd HH:mm:ss
completion_status否integer完成状态：0--未完成，1--已完成
market_channel_ids否array门店id列表，筛选多个门店，例：[1,2,3]
relation_ids否array门店用户关系ID列表，批量查询指定用户关系，例：[2001,2002,2003]
sort_order否string排序方式：asc（升序）、desc（降序），默认 desc，按关系记录ID排序

请求示例 ​

基础查询示例

json
{
    "name": "",                    // 用户名称，模糊搜索，非必填
    "mobile": "",                  // 用户手机号，模糊搜索，非必填
    "wechat_user_space_id": 0,     // 微信用户空间id，非必填
    "sale_name": "",               // 销售员名称，模糊搜索，非必填
    "market_channel": "",          // 门店名称，模糊搜索，非必填
    "manager_name": "",            // 管理员名称，模糊搜索，非必填
    "start_time": "",              // 开始时间，格式：yyyy-MM-dd HH:mm:ss，非必填
    "end_time": "",                // 结束时间，格式：yyyy-MM-dd HH:mm:ss，非必填
    "completion_status": 0,        // 完成状态：0--未完成，1--已完成，非必填
    "page": 1,                     // 页码，从1开始，必填
    "page_size": 5,                // 每页条数，最大300，必填
    "market_channel_ids": [1,2,3],  // 门店id列表，筛选多个门店，非必填
    "relation_ids": [],              // 门店用户关系ID列表，批量查询指定用户关系，非必填
    "sort_order": "desc"             // 排序方式：asc-升序，desc-降序，默认desc，非必填
}

批量查询指定用户关系示例

json
{
    "relation_ids": [2001, 2002, 2003],  // 门店用户关系ID列表，批量查询指定用户关系，非必填
    "page": 1,                     // 页码，从1开始，必填
    "page_size": 10                 // 每页条数，最大300，必填
}

响应参数 ​

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

data 参数结构 ​

参数必选类型描述
list是array用户列表
total是integer总数量
isOpenWatchDuration是boolean是否开启观看时长统计

list 参数结构 ​

参数必选类型描述
wechat_user_space_id是integer微信用户id
name是string用户名称
photo是string用户头像
invite_time是integer邀请时间戳
sale_name是string销售员名称
mobile是string用户手机号
market_channel是string门店名称
manager_name是string管理员名称
director_name是string负责人名称
status是integer用户状态 1正常 2禁用
market_channel_sale_id是integer门店销售员id
relation_id是integer关系id
invite_time_date是string邀请时间
completion_status是integer完成状态 0未完成 1已完成
watch_progress是string观看进度
channel_id是integer所属门店id

响应示例 ​

json
{
    "code": 200,
    "data": {
        "total": 2,
        "list": [
            {
                "wechat_user_space_id": 10001,
                "name": "张三",
                "photo": "https://example.com/avatar1.jpg",
                "invite_time": 1640995200,
                "sale_name": "销售员A",
                "mobile": "13800138000",
                "market_channel": "示例门店",
                "manager_name": "管理员A",
                "director_name": "负责人A",
                "status": 1,
                "market_channel_sale_id": 1001,
                "relation_id": 2001,
                "invite_time_date": "2024-01-01 00:00:00",
                "completion_status": 1,
                "watch_progress": "50%",
                "channel_id": 3128468
            },
            {
                "wechat_user_space_id": 10002,
                "name": "李四",
                "photo": "https://example.com/avatar2.jpg",
                "invite_time": 1641081600,
                "sale_name": "销售员B",
                "mobile": "13900139000",
                "market_channel": "示例门店",
                "manager_name": "管理员B",
                "director_name": "负责人B",
                "status": 1,
                "market_channel_sale_id": 1002,
                "relation_id": 2002,
                "invite_time_date": "2024-01-02 00:00:00",
                "completion_status": 0,
                "watch_progress": "30%",
                "channel_id": 3128468
            }
        ],
        "isOpenWatchDuration": true
    },
    "msg": "Success"
}