1. 分页列表
请求方法
POST
请求地址
/v2/dm/listQoes
Body参数
参数名称
数据类型
是否必须
参数说明
skip
Long
否
跳过的记录数,默认为0
limit
Long
否
获取的最大记录数,默认为10,最大500
autoCount
Boolean
否
是否要返回记录总数据量
filter
Filter
否
搜索参数
Filter对象定义
参数
数据类型
是否必需
描述
mac
String
否
设备MAC,最大长度17,支持带:或-,如00:15:65:bb:b1:a9
siteIds
List
false
要查询的站点ID列表
startTime
Long
false
要查询的起始时间
endTime
Long
false
要查询的结束时间
响应参数
参数
数据类型
描述
skip
Long
偏移量
limit
Long
返回最大数量
total
Long
总数据量
data
QoeInfo[]
QoeInfo信息数组
QoeInfo对象定义
名称
类型
描述
id
String
QOE记录id
deviceName
String
设备名称
mac
String
MAC
modelName
String
设备型号
firmwareVersion
String
固件版本
username
String
账号-用户名
displayName
String
账号-显示名称
siteName
String
归属站点
quality
String
通话质量 Good,Poor,Bad
startTime
long
通话开始时间戳
endTime
long
通话结束时间戳
callerURI
String
主叫URL,fromURI
calleeURI
String
被叫URL,toURI
duration
long
通话持续时间(ms)
请求消息示例
POST /v2/dm/listQoes HTTP/1.1
Host: api.ydmp.yealink.com
Content-Type: application/json
{
"skip":0,
"limit":10,
"filter":{
"startTime":1700876148000,
"endTime":1703468148329,
"siteIds":["126b25122362470daca91ae8ad038a27"]
}
}
响应消息示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"skip": 0,
"limit": 10,
"total": 1,
"data":[{
"id": "a26b25122362470daca91ae8ad038a27",
"deviceName": null,
"mac": "805ec091cfc6",
"modelName": "UNKNOW",
"firmwareVersion": "108.86.0.57",
"username": "8195",
"displayName": "8195",
"siteName": "global测试-baiyf",
"quality": "Good",
"startTime": 1660542991000,
"endTime": 1660543218000,
"callerURI": "\"8195\" <sip:8195@ume.yealink.com:5061>",
"calleeURI": "<sip:77031@ume.yealink.com>",
"duration": 227000
}]
}
2. QOE详情
请求方法
GET
请求地址
/v2/dm/qoe/{qoeId}
Path参数
参数
数据类型
是否必需
描述
qoeId
String
是
QOE记录 ID
响应参数
名称
类型
描述
id
String
QOE记录id
sessionId
String
通话的会议ID
reportTime
long
通话数据上报时间
deviceName
String
设备名称
mac
String
MAC
modelName
String
设备型号
firmwareVersion
String
固件版本
ip
String
设备IP
deviceType
String
设备类型:audio,video
username
String
账号-用户名
displayName
String
账号-显示名称
serverType
String
账号类型
siteName
String
归属站点
quality
String
通话质量 Good,Poor,Bad
startTime
long
通话开始时间戳
endTime
long
通话结束时间戳
callId
String
通话Id
callerURI
String
主叫URL,fromURI
calleeURI
String
被叫URL,toURI
isCaller
boolean
是否为主叫
callType
String
通话类型
confURI
String
配置url
time
long
当前时间
event
String
事件
duration
long
通话持续时间(ms)
inJitterAvg
int
输入抖动平均值
inJitterMax
int
输入抖动最大值
inLossRateAvg
double
输入丢失率平均值
inLossRateMax
double
输入丢失率最大值
inLossTotal
int
输入丢失值
inDelayAvg
int
输入延迟平均值
inDelayMax
int
输入延迟最大值
inListenMosAvg
double
输入接听语音质量评分平均值
inListenMosMin
double
输入接听语音质量评分最小值
inConversationalMosAvg
double
输入对话语音质量评分平均值
inConversationalMosMin
double
输入对话语音质量评分最小值
inReceivePacketTotal
int
入包总数
inPayloadName
String
输入负载名称
outJitterAvg
int
输出抖动平均值
outJitterMax
int
输出抖动最大值
outLossRateAvg
double
输出丢失率平均值
outLossRateMax
double
输出丢失率最大值
outLossTotal
int
输出丢失值
outDelayAvg
int
输出延迟平均值
outDelayMax
int
输出延迟最大值
outListenMosAvg
double
输出接听语音质量评分平均值
outListenMosMin
double
输出接听语音质量评分最小值
outConversationalMosAvg
double
输出对话语音质量评分平均值
outConversationalMosMin
double
输出对话语音质量评分最小值
outReceivePacketTotal
int
出包总数
outPayloadName
String
输出负载名称
请求消息示例
GET /v2/dm/qoe/c5a56e74bab546c8bc3cccf2e82aeb0c HTTP/1.1
Host: api.ydmp.yealink.com
响应消息示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"id": "a26b25122362470daca91ae8ad038a27",
"sessionId": "805ec091cfc6-0_934910374@10.50.144.6",
"reportTime": 1660543237204,
"deviceName": null,
"mac": "805ec091cfc6",
"modelName": "UNKNOW",
"firmwareVersion": "108.86.0.57",
"ip": "10.50.144.6",
"deviceType": "UNKNOW",
"username": "8195",
"displayName": "8195",
"serverType": "SIP",
"siteName": "global测试-baiyf",
"quality": "Good",
"startTime": 1660542991000,
"endTime": 1660543218000,
"callId": "0_934910374@10.50.144.6",
"callerURI": "\"8195\" <sip:8195@ume.yealink.com:5061>",
"calleeURI": "<sip:77031@ume.yealink.com>",
"remoteIP": null,
"callType": "p2p",
"confURI": null,
"time": 1660543218000,
"event": "0",
"duration": 227000,
"inJitterAvg": 3,
"inJitterMax": 3,
"inLossRateAvg": 0.0,
"inLossRateMax": 0.0,
"inDelayAvg": 5,
"inDelayMax": 5,
"inListenMosAvg": 4.0,
"inListenMosMin": 4.0,
"inConversationalMosAvg": 4.0,
"inConversationalMosMin": 4.0,
"inReceivePacketTotal": 11299,
"inPayloadName": "G722",
"outJitterAvg": 3,
"outJitterMax": 4,
"outLossRateAvg": 0.0,
"outLossRateMax": 0.0,
"outLossTotal": 0,
"outDelayAvg": 5,
"outDelayMax": 5,
"outListenMosAvg": 4.4,
"outListenMosMin": 4.0,
"outConversationalMosAvg": 4.4,
"outConversationalMosMin": 4.4,
"outReceivePacketTotal": 11333,
"outPayloadName": "G722",
}