基础服务API分为设备原始数据API和系统指标数据API,系统指标数据API由系统预置,可以直接查看并调用。当产品中有设备上报数据时,将生成设备原始数据API,您可以调用该API获取对应数据。本文介绍如何查看基础服务API。
前提条件
查看设备原始数据API,需已创建产品和设备,并备份。具体操作,请参见数据存储备份。
操作步骤
- 登录物联网平台控制台。
- 在实例概览页面,找到对应的数据型实例,单击实例进入实例详情页面。
- 在左侧导航栏,选择数据分析 > 数据API。
- 在基础服务API页面,查看设备原始数据API和系统指标数据API。
- 设备原始数据API
当产品中有设备上报数据时,将生成设备原始数据API。您可以调用该API查看指定产品中设备上报的历史数据。
- API名称为
${productName}原始数据查询
,${productName}
为产品名称。 - API Path为
/${productKey}/rawDate/get
,${productKey}
为产品的唯一标识。
如下图所示:
- API名称为
- 系统指标数据API
您可以调用该API来查看实例中所有设备的运行情况。已预置的系统指标数据API,如下表所示。您也可实例化系统指标表,生成更多的系统指标数据API。具体操作,请参见生成系统指标数据API。
API名称 API Path 说明 任意时间段内每小时设备数量相关统计 /iot-060a****/system/query/hourly_slot_dev_cnt_stat 统计实例中每小时在线设备的数量。 任意时间段内每小时设备上报事件数统计 /iot-060a****/system/query/hourly_slot_dev_event_cnt_stat 统计实例中每小时设备上报的事件数量。 任意时间段内每日设备上报事件数统计 /iot-060a****/system/query/daily_slot_dev_event_cnt_stat 统计每日设备上报的事件数量。 任意时间段内每小时设备连接次数统计 /iot-060a****/system/query/hourly_slot_dev_connect_cnt_stat 统计每小时设备的连接次数。 任意时间段内每小时设备在线时长统计 /iot-060a****/system/query/hourly_slot_dev_online_time_stat 统计每小时设备的在线时长。 任意时间段内每日设备上下行消息统计 /iot-060a****/system/query/daily_slot_dev_fee_msg_stat 统计每日设备的上下行消息。 任意时间段内每日设备连接次数统计 /iot-060a****/system/query/daily_slot_dev_connect_cnt_stat 统计每日设备的连接次数。 任意时间段内每小时设备上下行消息统计 /iot-060a****/system/query/hourly_slot_dev_fee_msg_stat 统计每小时设备的上下行消息。 任意一日设备SDK版本分布排行 /iot-060a****/system/query/1d_dev_cnt_sdk_dist 查询任意一日设备的SDK版本。 任意时间段内每日设备在线时长统计 /iot-060a****/system/query/daily_slot_dev_online_time_stat 统计每日设备的在线时长。 历史至今设备SDK版本分布排行 /iot-060a****/system/query/hist_dev_cnt_sdk_dist 查询设备历史至今的SDK版本。 历史至今设备连网协议分布排行 /iot-060a****/system/query/hist_dev_cnt_connect_protocol_dist 查询设备历史至今的连网协议。 任意一日设备连网协议分布排行 /iot-060a****/system/query/1d_dev_cnt_connect_protocol_dist 查询任意一日设备的连网协议。 任意一日设备连网方式分布排行 /iot-060a****/system/query/1d_dev_cnt_connect_mode_dist 查询任意一日设备的连网方式。 历史至今设备连网方式分布排行 /iot-060a****/system/query/hist_dev_cnt_connect_mode_dist 查询设备历史至今的连网方式。 历史至今设备品类分布排行 /iot-060a****/system/query/hist_dev_cnt_category_dist 查询设备历史至今的种类。 任意一日设备品类分布排行 /iot-060a****/system/query/1d_dev_cnt_category_dist 查询设备任意一日的种类。 历史至今设备省份区域分布排行 /iot-060a****/system/query/hist_dev_cnt_district_dist_rank 查询设备历史至今的省份区域。 任意一日设备区域分布排行 /iot-060a****/system/query/1d_dev_cnt_district_dist_rank 查询设备任意一日的省份区域。 历史至今地区设备数统计 /iot-060a****/system/query/hist_dev_cnt_district_dist_detail 查询设备历史至今的地区数量。 任意1日地区设备数统计 /iot-060a****/system/query/1d_dev_cnt_district_dist_detail 查询任意一日设备的地区数量。 历史至今设备数量相关统计 /iot-060a****/system/query/hist_dev_cnt_stat 统计历史至今设备的数量。 任意时间段内每日设备数量相关统计 /iot-060a****/system/query/slot_1d_dev_cnt_stat 统计每日设备的数量。
- 设备原始数据API