Yach开放平台

# 群聊

# 创建群

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/create?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_name String 是 群名称
group_owner String 是 群主userid 例如yach091805
group_userids String 是 群成员列表，半角竖线分割开来，group_userids 人数不得超过1000人
source String 否 群类型（0:普通群 3:审批群 4:项目群，默认0）
unique_key String 否 唯一值，用于验证幂等性，没有该参数，每个请求会自动生成一个

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
        "group_id": "2771361680",
        "name": "测试建群",
        "pic": "群头像链接地址"
    }
}

# 修改群聊

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/edit?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群聊Tid
group_name String 否 群名称
group_owner String 否 群主userid 例如yach091805
invite_uid String 否 邀请人的userid 例如yach091805
del_useridlist String 否 删除群成员列表，竖线分割开来，del_useridlist 人数不得超过40人
add_useridlist String 否 添加群成员列表，竖线分割开来，add_useridlist 人数不得超过40人

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
        "group_yach_id": 49560636174241884
    }
}

# 获取群基本信息

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/info?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
        "group": {
                  "group_tid": "2771348607",
                  "group_name": "好好学习",
                  "group_icon": "",
                  "group_users_count": 3,
                  "group_owner": "Yach076429",
                  "group_manager":{
                      "Yach111",
                      "Yach222"
                  }
              },
              "uidlist": [ // 该接口只返回20个群成员，如需获取全部成员请使用群成员列表接口
                  "Yach137620",
                  "Yach076429",
                  "Yach091805"
              ]
    }
}

# 查询用户是否在群里

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/checkin?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id
user_id String 是 员工yach唯一标识，示例：yach076429

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
        "status": 1（1:在群里面 0:不在群里面）
    }
}

# 获取群成员列表

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/users/list?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id
page String 否 当前页数，默认1
count String 否 每页显示条数，最大100

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
        "total":100, // 群成员总数
        "list": [
            {
                 "uuid": "Yach137620", // 用户yachid
                 "name": "好好学习", // 用户姓名
                 "pic": "", // 用户头像
                 "group_users_type": 0 // 用户在群里的类型（0:群主 1:管理员 2:普通用户）
            },
            {
                 "uuid": "Yach076429", // 用户yachid
                 "name": "天天向上", // 用户姓名
                 "pic": "", // 用户头像
                 "group_users_type": 2 // 用户在群里的类型（0:群主 1:管理员 2:普通用户）
            }
    }
}

# 获取群管理员和群主

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/manager?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id

返回值

{
    "code": 200,
    "msg": "",
    "obj": [
            {
                 "uuid": "Yach137620", // 用户yachid
                 "name": "好好学习", // 用户姓名
                 "work_code": "123001", // 用户工号
                 "group_users_type": 0 // 用户在群里的类型（0:群主 1:管理员 2:普通用户）
            },
            {
                 "uuid": "Yach076429", // 用户yachid
                 "name": "天天向上", // 用户姓名
                 "work_code": "456001", // 用户工号
                 "group_users_type": 2 // 用户在群里的类型（0:群主 1:管理员 2:普通用户）
            }
    ]
}

# 获取/搜索用户所管理的群列表

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/manage/list
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
user_id String 是 用户的yachid
group_name String 否 群名称

返回值

{
    "code": 200,
    "msg": "",
    "obj": [
        {
             "group_tid": "3821638765", // 群组tid
             "group_name": "好好学习", // 群组名称
             "group_icon": "", // 群组头像
             "group_users_count": 10 // 群人数
        }
    ]
}

# 添加群成员

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/users/add?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id
userid_list String 是 用户的yachid列表，Json字符串，示例：['Yach076429', 'Yach137620']
op_uid String 是 邀请人的yachid

返回值

{
    "code": 200,
    "msg": "",
    "obj": {}
}

# 移除群成员

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/users/del?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id
userid_list String 是 用户的yachid列表，Json字符串，示例：['Yach076429', 'Yach137620']
op_uid String 是 操作用户的yachid

返回值

{
    "code": 200,
    "msg": "",
    "obj": {}
}

# 更换群主

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/changeowner?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id
new_owner String 是 新群主的yachid
old_owner String 是 旧群主的yachid

返回值

{
    "code": 200,
    "msg": "",
    "obj": {}
}

# 设置群管理员

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/setadmin?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id
admin_users String 是 要设置的管理员yachid列表，Json字符串（单次最多10个管理员）
owner_uid String 是 群主的yachid

返回值

{
    "code": 200,
    "msg": "",
    "obj": {}
}

# 取消群管理员

# host: https://yach-oapi.zhiyinlou.com 正式环境

# host: https://yach-oapi-test.zhiyinlou.com 测试环境

# 概述

名称 值
地址 /group/removeadmin?access_token=ACCESS_TOKEN
请求方式 POST
参数 见【参数】
返回值 见【返回值】

# 参数

参数 参数类型 必须 说明
access_token String 是 调用接口凭证
group_tid String 是 群id
admin_users String 是 要取消的管理员yachid列表，Json格式（单次最多10个管理员）
owner_uid String 是 群主的yachid

返回值

{
    "code": 200,
    "msg": "",
    "obj": {}
}
上次更新: 8/20/2021, 11:50:46 AM

← 普通消息 →

foo