企业微信获取数据

最新推荐文章于 2024-05-24 14:47:54 发布

Ezio的学习之旅

最新推荐文章于 2024-05-24 14:47:54 发布

阅读量1k

点赞数

分类专栏：小程序文章标签：微信

原文链接：https://work.weixin.qq.com/api/doc/

版权

小程序专栏收录该内容

3 篇文章 0 订阅

订阅专栏

获取直播观看明细

通过该接口可以获取所有观看直播的人员统计
请求方式：POST（HTTPS）
请求地址：

https://qyapi.weixin.qq.com/cgi-bin/living/get_watch_stat?access_token=ACCESS_TOKEN

请求包体：

{
"livingid": "livingid1",
"next_key": "NEXT_KEY"
}

参数说明：

参数	必须	说明
access_token	是	调用接口凭证
livingid	是	直播的id
next_key	否	上一次调用时返回的next_key，初次调用可以填”0”

权限说明：

「上课直播/直播」应用有获取用户的所有直播
自建应用和第三方应用只能获取本应用创建的直播

返回结果：

{
   "errcode": 0,
   "errmsg": "ok",
   "ending":1,
   "next_key": "NEXT_KEY",
   "stat_info":{
        "users":[
            {
                "userid": "userid",
                "watch_time": 30,
                "is_comment": 1,
                "is_mic": 1
            }
        ],
        "external_users":[
            {
                "external_userid": "external_userid1",
                "type": 1,
                "name": "user name",
                "watch_time": 30,
                "is_comment": 1,
                "is_mic": 1
            },
            {
                "external_userid": "external_userid2",
                "type": 2,
                "name": "user_name",
                "watch_time": 30,
                "is_comment": 1,
                "is_mic": 1
            }
        ],
   }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
ending	是否结束。0：表示还有更多数据，需要继续拉取，1：表示已经拉取完所有数据。注意只能根据该字段判断是否已经拉完数据
next_key	当前数据最后一个key值，如果下次调用带上该值则从该key值往后拉，用于实现分页拉取
stat_info	统计信息列表
stat_info.users	观看直播的企业成员列表
stat_info.users.userid	企业成员的userid
stat_info.users.watch_time	观看时长，单位为秒
stat_info.users.is_comment	是否评论。0-否；1-是
stat_info.users.is_mic	是否连麦发言。0-否；1-是
stat_info.users.invitor_userid	邀请人的userid
stat_info.users.invitor_external_userid	邀请人的external_userid
stat_info.external_users	观看直播的外部成员列表
stat_info.external_users.external_userid	外部成员的userid
stat_info.external_users.type	外部成员类型，1表示该外部成员是微信用户，2表示该外部成员是企业微信用户
stat_info.external_users.name	外部成员的名称
stat_info.external_users.watch_time	观看时长，单位为秒
stat_info.external_users.is_comment	是否评论。0-否；1-是
stat_info.external_users.is_mic	是否连麦发言。0-否；1-是
stat_info.external_users.invitor_userid	邀请人的userid，邀请人为企业内部成员时返回（观众首次进入直播时，其使用的直播卡片/二维码所对应的分享人；仅“推广产品”直播支持）
stat_info.external_users.invitor_external_userid	邀请人的external_userid，邀请人为非企业内部成员时返回（观众首次进入直播时，其使用的直播卡片/二维码所对应的分享人；仅“推广产品”直播支持）

获取会议详情

请求方式： POST（HTTPS）

请求地址：

https://qyapi.weixin.qq.com/cgi-bin/meeting/get_info?access_token=ACCESS_TOKEN

请求包体：

{
"meetingid": "XXXXXXXXX"
}

参数说明：

参数	必须	说明
access_token	是	调用接口凭证。获取方法查看“获取access_token”
meetingid	是	会议id

权限说明：

系统应用「会议」可以拉取所有成员的会议
自建应用和第三方应用只能拉取该应用创建的会议

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "creator_userid": "zhangsan",
    "title": "title",
    "reserve_meeting_start ": 1600000000,
    "reserve_meeting_duration": 1600003600,
    "meeting_start": 1600000007,
    "meeting_duration": 1800,
    "description": "test meeting description",
    "main_department": 1,
    "type": 1,
    "status": 1,
    "remind_time": 60,
    "attendees": {
        "member": [
            {
                "userid": "lisi",
                "status": 1
            },
            {
                "userid": "zhangsan",
                "status": 2
            }
        ],
        "external_user": [
            {
                "external_userid": "woabc",
                "status": 3
            },
            {
                "external_userid": "woefd",
                "status": 4
            }
        ],
        "device": [
            {
                "device_sn": "devicesn1",
                "status": 5
            },
            {
                "device_sn": "devicesn1",
                "status": 5
            }
        ]
    }
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
creator_userid	会议发起者的userId
title	会议的标题，最大60个字节
reserve_meeting_start	会议预约的开始时间的unix时间戳
reserve_meeting_duration	会议预约时长
meeting_start	会议开始时间的unix时间戳
meeting_duration	会议时长
description	会议的描述，最大600字节
main_department	发起人所在部门
type	会议的类型，1：表示视频会议，2：表示语音会议
status	会议的状态，1：待开始，2：会议中，3：已结束，4：已取消，5：已过期
remind_time	指定会议开始前多久提醒用户，相对于meeting_start前的秒数
attendees	会议成员
attendees.member	企业内部成员
attendees.member.userid	企业内部成员的userid
attendees.member.status	与会议状态。1为已参与，2为未参与，3为已接受，4为已拒绝，5为待定，6为未处理
attendees.external_user	外部联系人
attendees.external_user.external_userid	外部联系人的external_userid
attendees.external_user.status	与会议状态。1为已参与，2为未参与，3为已接受，4为已拒绝，5为待定，6为未处理，对于外部的微信用户暂时不提供状态信息，默认为0
attendees.device	会议硬件设备
attendees.device.device_sn	会议硬件设备sn
attendees.device.status	与会议状态。1为已参与，2为未参与，3为已接受，4为已拒绝，5为待定，6为未处理

获取公告（目前查阅暂不支持）

获取群聊会话

获取群聊会话 - 企业获取群聊会话 - 企业微信API 获取群聊会话 - 企业

请求方式： GET（HTTPS）
请求地址：

https://qyapi.weixin.qq.com/cgi-bin/appchat/get?access_token=ACCESS_TOKEN&chatid=CHATID

参数说明：

参数	是否必须	说明
access_token	是	调用接口凭证
chatid	是	群聊id

权限说明：
只允许企业自建应用调用，且应用的可见范围必须是根部门；
chatid所代表的群必须是该应用所创建；
第三方不可调用。

返回示例：

 {
   "errcode" : 0,
   "errmsg" : "ok",
   "chat_info" : {
      "chatid" : "CHATID",
      "name" : "NAME",
      "owner" : "userid2",
      "userlist" : ["userid1", "userid2", "userid3"]
   }
 }

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
chat_info	群聊信息
chatid	群聊唯一标志
name	群聊名
owner	群主id
userlist	群成员id列表

作业提交（经查阅暂无API）

Ezio的学习之旅

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
企业微信获取数据

获取直播观看明细通过该接口可以获取所有观看直播的人员统计请求方式：POST（HTTPS）请求地址：https://qyapi.weixin.qq.com/cgi-bin/living/get_watch_stat?access_token=ACCESS_TOKEN请求包体：{ "livingid": "livingid1", "next_key": "NEXT_KEY" }参数说明：参数必须说明 access_token 是..
复制链接

扫一扫

专栏目录