dingtalk.oapi.enterprise.mainorg.totaldata.stat (组织整体统计指标接口)

根据stat_date和corp_id查询组织整体统计指标

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
stat_date String 必须 20190723 查询时间
corp_id String 必须 dingabcd 企业ID
return_fields String [] 必须 STAT_DATE,CORP_ID
  • 最大列表长度:50
  • active_mbr_cnt_std 在线组织激活用户数 ; all_group_cnt 全员群数量; carbon_amount_1d 最近1天降低碳排量G; carbon_amount_1w 最近7天降低碳排量G; corp_id 企业ID; dept_group_cnt 部门群数量; ding_save_hour_1d 最近1天钉办节约小时; ding_save_hour_1w 最近7天钉办节约小时; inner_group_cnt 内部群数量; live_launch_succ_cnt_1d 最近1天成功发起直播次数;live_launch_succ_cnt_1w 最近7天成功发起直播次数; mbr_cnt_std 在线组织通讯录人数(注册人数);online_conference_cnt_1d 最近1天在线会议次数;online_conference_cnt_7d 最近7天在线会议次数; online_org_cnt 在线组织数; org_online_ratio 组织覆盖率; real_org_cnt 实际组织数; receive_ding_user_cnt_1d 最近1天接收DING的用户数;receive_ding_user_cnt_1w 最近7天接收DING的用户数; rel_org_cnt 关联组织数 send_message_user_cnt_1d 最近1天发送消息人数;send_message_user_cnt_1w 最近7天发送消息人数; stat_date 统计日期
    order_by OrderBy 可选 排序
    • └ field
    • String
    • 可选
    • STAT_DATE
    • 排查的key
    • └ order
    • String
    • 可选
    • ACS或者DESC
    • 升序或者降序
    page_start Number 必须 0 分页起始点
    page_size Number 必须 30 分页查询条数,最多30条

    响应参数

    名称 类型 示例值 描述
    result MainStatDataVo [] 100 系统自动生成
    • └ active_mbr_cnt_std
    • String
    • 100
    • 在线组织激活用户数
    • └ all_group_cnt
    • String
    • 100
    • 全员群数量
    • └ carbon_amount_1d
    • String
    • 100
    • 最近1天降低碳排量G
    • └ carbon_amount_1w
    • String
    • dingabcd
    • 最近7天降低碳排量G
    • └ corp_id
    • String
    • 100
    • 企业ID
    • └ dept_group_cnt
    • String
    • 100
    • 部门群数量
    • └ ding_save_hour_1d
    • String
    • 100
    • 最近1天钉办节约小时
    • └ ding_save_hour_1w
    • String
    • 100
    • 最近7天钉办节约小时
    • └ innerGroupCnt
    • String
    • 100
    • 内部群数量
    • └ liveLaunchSuccCnt1d
    • String
    • 100
    • 最近1天成功发起直播次数
    • └ liveLaunchSuccCnt1w
    • String
    • 100
    • 最近7天成功发起直播次数
    • └ mbr_cnt_std
    • String
    • 100
    • 在线组织通讯录人数
    • └ online_conference_cnt_1d
    • String
    • 100
    • 最近1天在线会议次数
    • └ online_conference_cnt_7d
    • String
    • 100
    • 最近7天在线会议次数
    • └ online_org_nt
    • String
    • 100
    • 在线组织数
    • └ org_online_ratio
    • String
    • 100
    • 组织覆盖率
    • └ real_org_cnt
    • String
    • 100
    • 实际组织数
    • └ receive_ding_user_cnt_1d
    • String
    • 100
    • 最近1天接收DING的用户数
    • └ receive_ding_user_cnt_1w
    • String
    • 100
    • 最近7天接收DING的用户数
    • └ rel_org_nt
    • String
    • 100
    • 关联组织数
    • └ send_message_user_cnt_1d
    • String
    • 100
    • 最近1天发送消息人数
    • └ end_message_user_cnt_1w
    • String
    • 100
    • 最近7天发送消息人数
    • └ stat_date
    • String
    • 20190826
    • 统计日期
    success Boolean true 是否成功
    errcode Number 400002 错误码
    errmsg String 参数错误 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/enterprise/mainorg/totaldata/stat");
    OapiEnterpriseMainorgTotaldataStatRequest req = new OapiEnterpriseMainorgTotaldataStatRequest();
    req.setStatDate("20190723");
    req.setCorpId("dingabcd");
    req.setReturnFields("STAT_DATE,CORP_ID");
    OrderBy obj1 = new OrderBy();
    obj1.setField("STAT_DATE");
    obj1.setOrder("ACS或者DESC");
    req.setOrderBy(obj1);
    req.setPageStart(0L);
    req.setPageSize(30L);
    OapiEnterpriseMainorgTotaldataStatResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "result":[
            {
                    "active_mbr_cnt_std":"100",
                    "all_group_cnt":"100",
                    "carbon_amount_1d":"100",
                    "carbon_amount_1w":"dingabcd",
                    "corp_id":"100",
                    "dept_group_cnt":"100",
                    "ding_save_hour_1d":"100",
                    "ding_save_hour_1w":"100",
                    "innerGroupCnt":"100",
                    "liveLaunchSuccCnt1d":"100",
                    "liveLaunchSuccCnt1w":"100",
                    "mbr_cnt_std":"100",
                    "online_conference_cnt_1d":"100",
                    "online_conference_cnt_7d":"100",
                    "online_org_nt":"100",
                    "org_online_ratio":"100",
                    "real_org_cnt":"100",
                    "receive_ding_user_cnt_1d":"100",
                    "receive_ding_user_cnt_1w":"100",
                    "rel_org_nt":"100",
                    "send_message_user_cnt_1d":"100",
                    "end_message_user_cnt_1w":"100",
                    "stat_date":"20190826"
            }
        ],
        "success":true,
        "errcode":400002,
        "errmsg":"参数错误"
    }

    异常示例

    • JSON示例
    {
    	"errcode":88,
    	"errmsg":"ding talk error"
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部