文档中心 > API类目 > 钉钉API

dingtalk.oapi.enterprise.subarea.totaldata.stat (所辖区域统计接口)

根据stat_date和corp_id查询所辖区域统计数据

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
stat_date	String	必须	20190723		查询时间
corp_id	String	必须	dingabcd		企业ID
return_fields	String []	必须	stat_date,corp_id	最大列表长度：50	act_ratio_1d_001 所辖区域活跃率; act_usr_cnt_1d_001 活跃用户数最近1天; active_mbr_cnt_std_001 历史截至当日激活会员数; active_mbr_ratio 所辖区域用户的激活率; city_lat 所属城市维度; city_lng 所属城市经度; county_lat 区/县纬度; county_lng 区/县经度; mbr_cnt_std_063 历史截至当日企业会员数; online_org_cnt 所辖区域在线组织数 ; org_online_ratio 所辖区域组织覆盖率 ; real_org_cnt 所辖区域实际组织数 ; send_message_cnt_1d 发送消息数量; send_message_user_cnt_1d 发送消息人数;
order_by	OrderBy	可选			排序
└ field String 可选 STAT_DATE 排查的key └ order String 可选 ACS或者DESC 升序或者降序
page_start	Number	必须	0		分页起始点
page_size	Number	必须	30		分页查询条数，最多30条

响应参数

名称	类型	示例值	描述
result	AreaStatDataVO []		系统自动生成
└ stat_date String 20190723 查询时间 └ corp_id String dingabcd 企业ID └ act_ratio_1d String 1 所辖区域活跃率 └ act_usr_cn_1d String 10 活跃用户数最近1天 └ active_mbr_cnt_std String 10 历史截至当日激活会员数 └ active_mbr_ratio String 1 所辖区域用户的激活率 └ city_lat String 10 所属城市维度 └ city_lng String 10 所属城市经度 └ county_lat String 10 区/县纬度 └ county_lng String 10 区/县经度 └ mbr_cnt_std String 10 历史截至当日企业会员数 └ online_org_cnt String 10 所辖区域在线组织数 └ org_online_ratio String 1 所辖区域组织覆盖率 └ real_org_cnt String 10 所辖区域实际组织数 └ send_message_cnt_1d String 10 发送消息数量 └ send_message_user_cnt_1d String 10 发送消息人数 └ city_name String 衢州市城市名称 └ county_name String 柯城区城市所在区域
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/subarea/totaldata/stat");
OapiEnterpriseSubareaTotaldataStatRequest req = new OapiEnterpriseSubareaTotaldataStatRequest();
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);
OapiEnterpriseSubareaTotaldataStatResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

{
    "result":[
        {
                "stat_date":"20190723",
                "corp_id":"dingabcd",
                "act_ratio_1d":"1",
                "act_usr_cn_1d":"10",
                "active_mbr_cnt_std":"10",
                "active_mbr_ratio":"1",
                "city_lat":"10",
                "city_lng":"10",
                "county_lat":"10",
                "county_lng":"10",
                "mbr_cnt_std":"10",
                "online_org_cnt":"10",
                "org_online_ratio":"1",
                "real_org_cnt":"10",
                "send_message_cnt_1d":"10",
                "send_message_user_cnt_1d":"10",
                "city_name":"衢州市",
                "county_name":"柯城区"
        }
    ],
    "success":true,
    "errcode":400002,
    "errmsg":"参数错误"
}

异常示例

JSON示例

{
    "errcode":88,
    "errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.enterprise.subarea.totaldata.stat (所辖区域统计接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ