获取话单

1、请求地址:

/base/{account}/getCallrecords?sign={sign}

2、请求参数:

属性 类型 约束 说明
callTime String 可选 话单呼叫时间,格式为“yyyy-MM-dd HH:mm:ss”,查询该时间之后的记录。
syncFlag Integer 可选 话单推送标识1表示获取推送成功的话单, 2表示获取通知失败话单 为空则获取全部话单
appId String 可选 应用标识。由平台提供,通过PAAS平台管理系统应用详情获取。
productionId Integer 可选 功能Id,1代表语音验证码,2代表中间号,3 代表语音通知 4代表双向外呼,5代表总机号,空默认为查询应用下的全部功能
size int 可选 每页展示的数据量,用于分页展示,默认为50
startId Long 可选 话单记录ID 获取指定ID之后的话单 空默认1

3、请求实例:

POST base/tdlxtest/getCallrecords?sig=31safacadffgaga121cdagavaf
HTTP/1.1
Host: 192.168.0.1:8888
content-length: 139
Accept: application/json;
Content-Type: application/json; charset=utf-8;
Authorization: ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2

{
    "syncFlag" : "1",
    "callTime" : "2016-10-01 12:30:00",
    "appId" : "tdlxtestapp",
    "productionId" : 5,
    "startId" : 1,
    "size" : 10,
}

4、响应结果:

属性 类型 约束 说明
code String 必选 请求状态码,取值200(成功),可参考Rest 错误代码。
msg String 可选 错误原因描述
data String 必选 正确返回数据

5、响应示例:

正确返回:

{
    "
code" : "200",
    "
msg" : null,
    "
data" : {
        "
value" : [{
            "
id" : 2,
            "
appid":"AEE12F0CBC04F333213B2D5C44CD5EC4,
            "
cost": "0.2",
            "
callernum": "13912345676",
            "
callid": "20160929111346006603",
            "
callednum": "018766666666",
            "
callershow": "40012345678-0001",
            "
calleeshow": null,
            "
startdate": "2016-10-29 11:13:46.0",
            "
enddate": "2016-10-29 11:14:13.0",
            "
answertime": "2016-10-29 11:14:04.0",
            "
soundurl": "http://voice.ucc360.com/xxx/xxxx.wav",
            "
billduration" : 27,
            "
callduration" : 9,
            "
minute" : 1,
            "
productionid" : 5,
            "
result" : "0",
            "
syncflag" : 1,
            "
calldata" : "",
        },
            ……
        ]
    }
}

返回参数说明:

属性 说明
appid 应用标识
id 话单id 查询用
cost 此条话单消 minute*费率
callernum 主叫号码
callid 话单标识
callednum 被叫号码
callershow 主叫外显号码
calleeshow 被叫外显号码
startdate 进入平台时间 即呼叫开始时间
enddate 离开平台时间 即呼叫结束时间
answertime 被叫应答时间
soundurl 录音地址
billduration 主叫通话时长 即 enddate-startdate
callduration 被叫通话时长 即 enddate-answertime
minute 分钟数 根据billduration/60 以整计
productionid 功能标识
result 通话结果,参照结果码对照表
syncflag 推送标识 1为推送成功 2推送失败
calldata 随路数据

错误返回:

{
    "
code" : "201",
    "
msg" : "xxxxx",
    "
data" : null
}

code对应不同错误码 msg,对应不同的错误信息提示