开发者中心
直播
视频教程知识库工单
中文
新手入门资源下载了解产品快速开始集成开发客户端 API服务端 API
在线咨询微信咨询电话咨询
服务端
动态与公告
活动与公告
【公告】请直播点播用户及时开启防盗链
平台服务
直播安全
直播防盗链
安全通
功能概述
开通直播安全通
审核结果回调
服务端 API
接口概述
直播管理
直播安全
直播录制
直播封面
直播截图
直播实时转码
直播回调
数据统计
开发者中心直播服务端 API数据统计

数据统计

更新时间： 2022/08/04 08:02:13

监控统计

上行推流质量数据

URL

POST https://data.netease.im/live/queryPushStreamStats HTTP/1.1
Content-Type: application/json;charset=utf-8

接口说明

  • 描述：上行推送到网易srs端的数据查询
  • 时间粒度：1 秒
  • 时效性：数据延迟不超过 1 分钟
  • 最大时间跨度为 1 小时
  • 最早支持 7 天前的查询

入参说明

参数名称 类型 是否必选 描述
domain String 是 域名
streamName String 是 流名
beginTime Long 是 开始时间，单位：ms，示例：1633017600000
endTime Long 是 结束时间，单位：ms，示例：1633017600000

响应说明

参数名称 类型 描述
code Integer 响应码 200 表示成功
msg String 响应消息
requestId String 请求追踪ID
data List<Object> Object对象列表

其中data对象结构：

参数名称 类型 描述
time Long 时间，单位ms，示例：1633017600000
pushDelay Integer 推流延迟 ms
audioCodec String 音频编码
videoCodec String 视频编码
audioFps Integer 音频帧率
videoFps Integer 视频帧率
audioRate Double 音频码率 kbps
videoRate Double 视频码率 kbps
clientIp String 客户端IP
streamBeginTime Long 推流开始时间，单位：ms，示例：1633017600000
resolution String 视频分辨率

请求示例

curl -X POST \
  -H "Content-Type: application/json;charset=utf-8" \
  -H "AppKey: 027338bf05cc4***c9d6af80b3" \
  -H "Nonce: 123222" \
  -H "CurTime: 1465723418" \
  -H "CheckSum: 61bbfd88c510***84e65a2abe7ae13" \
  -d '{
    "domain":"pdf695e79.live.126.net",
    "streamName": "881ebb79abcb4206963c594621f7e633",
    "beginTime": 1639462200000,
    "endTime": 1639462300000
  }' \
   https://data.netease.im/live/queryPushStreamStats

返回示例

{
    "code": 200,
    "msg": "",
    "requestId": "636328c6-a3d5-4c45-b5a9-953f20d0ab88",
    "data": [{
    	"time": 1639462200000,
    	"audioCodec": "ACC",
    	"videoCodec": "H264",
    	"audioFps": 32,
    	"videoFps": 30,
    	"audioRate": 700.12,
    	"videoRate": 2123.20,
    	"clientIp": "180.101.154.162",
    	"streamBeginTime": 1639462200000,
    	"resolution": "1280x720"
    }, {
    	"time": 1639462200000,
    	"audioCodec": "ACC",
    	"videoCodec": "H264",
    	"audioFps": 32,
    	"videoFps": 30,
    	"audioRate": 700.12,
    	"videoRate": 2123.20,
    	"clientIp": "180.101.154.162",
    	"streamBeginTime": 1639462200000,
    	"resolution": "1280x720"
    }]
}

下行流量查询

URL

POST https://data.netease.im/live/queryFlow HTTP/1.1
Content-Type: application/json;charset=utf-8

接口说明

  • 描述：下行流量查询
  • 时间粒度：5分钟
  • 时效性：数据延迟不超过5分钟
  • 最大时间跨度为 24小时
  • 最早支持7天前的查询

入参说明

参数名称 类型 是否必选 描述
domains List 是 域名list，示例： ["www.a.com","www.b.com"]
beginTime Long 是 开始时间，单位ms，示例：1633017600000
endTime Long 是 结束时间，单位ms，示例： 1633017600000
isp String 否 运营商英文标识，示例：cmc
area String 否 省份英文标识，示例：zhejiang

其中：

  1. isp仅支持中国内地的主要的运营商：
英文 中文 英文 中文 英文 中文
ctc 电信 ctt 铁通 cuc 联通
cmc 移动 cen 教育网
  1. area仅支持中国内地的省份：
英文 中文 英文 中文 英文 中文
beijing 北京 anhui 安徽 jilin 吉林
neimenggu 内蒙古 shandong 山东 liaoning 辽宁
shanxi 山西 shanghai 上海 fujian 福建
hebei 河北 zhejiang 浙江 jiangsu 江苏
tianjin 天津 henan 河南 hainan 海南
ningxia 宁夏 hubei 湖北 sichuan 四川
shaanxi 陕西 jiangxi 江西 xizang 西藏
gansu 甘肃 hunan 湖南 guangdong 广东
qinghai 青海 guizhou 贵州 guangxi 广西
xinjiang 新疆 yunnan 云南 chongqing 重庆
heilongjiang 黑龙江

响应说明

参数名称 类型 描述
code Integer 响应码 200 表示成功
msg String 响应消息
requestId String 请求追踪ID
data List<Object> Object对象列表

其中data对象结构：

参数名称 类型 描述
domain String 域名
tsStats List<Object> 时序统计对象列表

其中tsStats对象结构

参数名称 类型 描述
ts Long 时间戳，示例：1639462200000
value Double 统计值

请求示例

curl -X POST \
  -H "Content-Type: application/json;charset=utf-8" \
  -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" \
  -H "Nonce: 123222" \
  -H "CurTime: 1465723418" \
  -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" \
  -d '{"domains":["www.a.com","www.b.com"],"beginTime": 1639462200000,"endTime": 1639462800000}' \
   https://data.netease.im/live/queryFlow

返回示例

{
    "code": 200,
    "data": [
        {
            "domain": "www.a.com",
            "tsStats": [
                {
                    "ts": 1639462200000,
                    "value": 14.10
                },
                {
                    "ts": 1639462500000,
                    "value": 14.08
                }
            ]
        },
        {
            "domain": "www.b.com",
            "tsStats": [
                {
                    "ts": 1639462200000,
                    "value": 14.10
                },
                {
                    "ts": 1639462500000,
                    "value": 14.08
                }
            ]
        }
    ],
    "requestId": "86f530cf-f972-422c-9125-703f46754de2"
}

下行带宽查询

URL

POST https://data.netease.im/live/queryBandwidth HTTP/1.1
Content-Type: application/json;charset=utf-8

接口说明

  • 描述：下行带宽查询
  • 时间粒度：5分钟
  • 时效性：数据延迟不超过5分钟
  • 最大时间跨度为 24小时
  • 最早支持7天前的查询

入参说明

参数名称 类型 是否必选 描述
domains List 是 域名list，示例： ["www.a.com","www.b.com"]
beginTime Long 是 开始时间，单位ms，示例：1633017600000
endTime Long 是 结束时间，单位ms，示例： 1633017600000
isp String 否 运营商英文标识，示例：cmc
area String 否 省份英文标识，示例：zhejiang

响应说明

参数名称 类型 描述
code Integer 响应码 200 表示成功
msg String 响应消息
requestId String 请求追踪ID
data List<Object> Object对象列表

其中data对象结构：

参数名称 类型 描述
domain String 域名
tsStats List<Object> 时序统计对象列表

其中tsStats对象结构

参数名称 类型 描述
ts Long 时间戳，示例：1639462200000
value Double 统计值

请求示例

curl -X POST \
  -H "Content-Type: application/json;charset=utf-8" \
  -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" \
  -H "Nonce: 123222" \
  -H "CurTime: 1465723418" \
  -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" \
  -d '{"domains":["www.a.com","www.b.com"],"beginTime": 1639462200000,"endTime": 1639462800000}' \
   https://data.netease.im/live/queryBandwidth

返回示例

{
    "code": 200,
    "data": [
        {
            "domain": "www.a.com",
            "tsStats": [
                {
                    "ts": 1639462200000,
                    "value": 14.10
                },
                {
                    "ts": 1639462500000,
                    "value": 14.08
                }
            ]
        },
        {
            "domain": "www.b.com",
            "tsStats": [
                {
                    "ts": 1639462200000,
                    "value": 14.10
                },
                {
                    "ts": 1639462500000,
                    "value": 14.08
                }
            ]
        }
    ],
    "requestId": "86f530cf-f972-422c-9125-703f46754de2"
}

下行访问量查询

URL

POST https://data.netease.im/live/queryVisit HTTP/1.1
Content-Type: application/json;charset=utf-8

接口说明

  • 描述：下行访问量查询
  • 时间粒度：5分钟
  • 时效性：数据延迟不超过5分钟
  • 最大时间跨度为 24小时
  • 最早支持7天前的查询

入参说明

参数名称 类型 是否必选 描述
domains List 是 域名list，示例： ["www.a.com","www.b.com"]
beginTime Long 是 开始时间，单位ms，示例：1633017600000
endTime Long 是 结束时间，单位ms，示例： 1633017600000
isp String 否 运营商英文标识，示例：cmc
area String 否 省份英文标识，示例：zhejiang

响应说明

参数名称 类型 描述
code Integer 响应码 200 表示成功
msg String 响应消息
requestId String 请求追踪ID
data List<Object> Object对象列表

其中data对象结构：

参数名称 类型 描述
domain String 域名
tsStats List<Object> 时序统计对象列表

其中tsStats对象结构

参数名称 类型 描述
ts Long 时间戳，示例：1639462200000
value Double 统计值，单位：次

请求示例

curl -X POST \
  -H "Content-Type: application/json;charset=utf-8" \
  -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" \
  -H "Nonce: 123222" \
  -H "CurTime: 1465723418" \
  -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" \
  -d '{"domains":["www.a.com","www.b.com"],"beginTime": 1639462200000,"endTime": 1639462800000}' \
   https://data.netease.im/live/queryVisit

返回示例

{
    "code": 200,
    "data": [
        {
            "domain": "www.a.com",
            "tsStats": [
                {
                    "ts": 1639462200000,
                    "value": 1
                },
                {
                    "ts": 1639462500000,
                    "value": 1
                }
            ]
        },
        {
            "domain": "www.b.com",
            "tsStats": [
                {
                    "ts": 1639462200000,
                    "value": 1
                },
                {
                    "ts": 1639462500000,
                    "value": 1
                }
            ]
        }
    ],
    "requestId": "86f530cf-f972-422c-9125-703f46754de2"
}

下行http状态码查询

URL

POST https://data.netease.im/live/queryHttpCode HTTP/1.1
Content-Type: application/json;charset=utf-8

接口说明

  • 描述：下行http状态码查询
  • 时间粒度：5分钟
  • 时效性：数据延迟不超过5分钟
  • 最大时间跨度为 24小时
  • 最早支持7天前的查询

入参说明

参数名称 类型 是否必选 描述
domains List 是 域名list，示例： ["www.a.com","www.b.com"]
beginTime Long 是 开始时间，单位ms，示例：1633017600000
endTime Long 是 结束时间，单位ms，示例： 1633017600000
isp String 否 运营商英文标识，示例：cmc
area String 否 省份英文标识，示例：zhejiang

响应说明

参数名称 类型 描述
code Integer 响应码 200 表示成功
msg String 响应消息
requestId String 请求追踪ID
data List<Object> Object对象列表

其中data对象结构：

参数名称 类型 描述
domain String 域名
dataKey String 数据标识，这里指http状态码
tsStats List<Object> 时序统计对象列表

其中tsStats对象结构

参数名称 类型 描述
ts Long 时间戳，示例：1639462200000
value Double 统计值

请求示例

curl -X POST \
  -H "Content-Type: application/json;charset=utf-8" \
  -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" \
  -H "Nonce: 123222" \
  -H "CurTime: 1465723418" \
  -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" \
  -d '{"domains":["www.a.com","www.b.com"],"beginTime": 1639462200000,"endTime": 1639462800000}' \
   https://data.netease.im/live/queryHttpCode

返回示例

{
    "code": 200,
    "data": [
        {
            "dataKey": "200",
            "domain": "www.a.com",
            "tsStats": [
                {
                    "ts": 1639461900000,
                    "value": 1
                }
            ]
        },
        {
            "dataKey": "403",
            "domain": "www.a.com",
            "tsStats": [
                {
                    "ts": 1639462200000,
                    "value": 1
                },
                {
                    "ts": 1639462500000,
                    "value": 1
                }
            ]
        },
        {
            "dataKey": "200",
            "domain": "www.b.com",
            "tsStats": [
                {
                    "ts": 1639461900000,
                    "value": 1
                }
            ]
        }
    ],
    "requestId": "c2a531af-1906-4467-affd-88546617b7a1"
}

下行流历史在线人数查询

URL

POST https://data.netease.im/live/queryStreamHistoryUserNum HTTP/1.1
Content-Type: application/json;charset=utf-8

接口说明

  • 描述：下行流历史在线人数查询
  • 时间粒度：1分钟
  • 时效性：数据延迟不超过5分钟
  • 最大时间跨度为 24小时
  • 最早支持7天前的查询

入参说明

参数名称 类型 是否必选 描述
domain String 是 域名，示例：www.a.com
streamName String 是 流名，示例：abcdefg
beginTime Long 是 开始时间，单位ms，示例：1633017600000
endTime Long 是 结束时间，单位ms，示例：1633017600000

响应说明

参数名称 类型 描述
code Integer 响应码 200 表示成功
msg String 响应消息
requestId String 请求追踪ID
data List<Object> Object对象列表

其中data对象结构：

参数名称 类型 描述
domain String 域名
dataKey String 数据标识，这里指streamName
tsStats List<Object> 时序统计对象列表

其中tsStats对象结构

参数名称 类型 描述
ts Long 时间戳，示例：1639462200000
value Double 统计值

请求示例

curl -X POST \
  -H "Content-Type: application/json;charset=utf-8" \
  -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" \
  -H "Nonce: 123222" \
  -H "CurTime: 1465723418" \
  -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" \
  -d '{"domain":"www.a.com","streamName
  ":"abcdefg","beginTime": 1639462200000,"endTime": 1639462800000}' \
   https://data.netease.im/live/queryStreamHistoryUserNum

返回示例

{
    "code": 200,
    "data": {
        "dataKey": "abcdefg",
        "domain": "www.a.com",
        "tsStats": [
            {
                "ts": 1640851260000,
                "value": 1
            },
            {
                "ts": 1640851320000,
                "value": 1
            }
        ]
    },
    "requestId": "c169ea05-639c-41b2-b0c7-e880ec7b7ee4"
}

直播日志

直播日志查询

URL

POST https://data.netease.im/live/queryLogUrl HTTP/1.1
Content-Type: application/json;charset=utf-8

接口说明

  • 描述：查询实时日志的列表（请联系客户经理开通后才能正常使用）

入参说明

参数名称 类型 是否必选 描述
domain String 是 域名，示例：www.a.com
streamName String 是 流名，示例：abcdefg
beginTime Long 是 开始时间，单位ms，示例：1633017600000
endTime Long 是 结束时间，单位ms，示例：1633017600000

响应说明

参数名称 类型 描述
code Integer 响应码 200 表示成功
msg String 响应消息
requestId String 请求追踪ID
data List<Object> Object对象列表

其中data对象结构：

参数名称 类型 描述
time Long 时间，单位ms，示例：1633017600000
url String 日志文件url
size Integer 文件大小

请求示例

curl -X POST \
  -H "Content-Type: application/json;charset=utf-8" \
  -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" \
  -H "Nonce: 123222" \
  -H "CurTime: 1465723418" \
  -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" \
  -d '{
    "domain":"pdf695e79.live.126.net",
    "streamName": "881ebb79abcb4206963c594621f7e633",
    "beginTime": 1639462200000,
    "endTime": 1639462300000
  }' \
   https://data.netease.im/live/queryLogUrl

返回示例

{
    "code": 200,
    "msg": "",
    "requestId": "636328c6-a3d5-4c45-b5a9-953f20d0ab88",
    "data": [{
    	"time": 1639462200000,
    	"url": "http://nos.netease.com/vcloud-statistic/cdn_access_log%2Fwww.vdncloud.com_2021-11-18-19-35_5_0.gz?Signature=qT8u%2FjRB8Gj7Z7yr8zXLjpkkUBviyIRKQEg0g9%2BKSrA%3D&Expires=1638712699&NOSAccessKeyId=ab1856bb39044591939d7b94e1b8e5ee",
    	"size": 12445
    }, {
    	"time": 1639462200000,
    	"url": "http://nos.netease.com/vcloud-statistic/cdn_access_log%2Fwww.vdncloud.com_2021-11-18-19-35_5_0.gz?Signature=qT8u%2FjRB8Gj7Z7yr8zXLjpkkUBviyIRKQEg0g9%2BKSrA%3D&Expires=1638712699&NOSAccessKeyId=ab1856bb39044591939d7b94e1b8e5ee",
    	"size": 14401
    }]
}
在线咨询微信咨询电话咨询
此文档是否对你有帮助？
有帮助
去反馈
  • 监控统计
  • 上行推流质量数据
  • 下行流量查询
  • 下行带宽查询
  • 下行访问量查询
  • 下行http状态码查询
  • 下行流历史在线人数查询
  • 直播日志
  • 直播日志查询