查询分配的软电话号码 (V2.0.0) (queryPhone)
场景描述
查询分配的软电话号码V2接口。
接口方法
POST
接口URI
https://域名/apiaccess/CC-Management/v2/mobileAgent/queryPhone,例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
X-APP-Key |
string |
False |
appKey字段,用户标识 |
2 |
Authorization |
string |
True |
鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
limit |
string |
False |
分页查询时单页最多的记录条数,默认值100,即每页显示100条,非必选
|
1 |
offset |
string |
False |
分页查询偏移量,默认值0,即不需要偏移,非必选 |
响应说明
- 响应状态码: 200
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1.1 |
retCode |
string |
True |
返回码。0表示成功,其他为失败。 1:查询失败 2:移动座席信息为空 3:注册服务地址或端口为空 4:limit或offset分页数据为空 5:虚拟呼叫中心信息为空 |
1.2 |
retMsg |
string |
False |
失败原因的描述 |
1.3 |
result |
object |
False |
返回结果 |
1.3.1 |
total |
number |
False |
总记录数 |
1.3.2 |
singleRegServ |
array[object] |
False |
single模式 |
1.3.2.1 |
regIPAddress |
string |
False |
注册地址 长度限制:string(50) |
1.3.2.2 |
regPort |
string |
False |
注册端口 长度限制:number(5) |
1.3.2.3 |
sipServicePort |
string |
False |
软电话注册端口 长度限制:number(5) |
1.3.2.4 |
sipServiceIp |
string |
False |
软电话注册地址 长度限制:string(50) |
1.3.3 |
poolRegServ |
object |
False |
pool模式 |
1.3.3.1 |
node1 |
array[object] |
False |
节点1 |
1.3.3.1.1 |
regIPAddress |
string |
False |
注册地址 长度限制:string(50) |
1.3.3.1.2 |
regPort |
string |
False |
注册端口 长度限制:number(5) |
1.3.3.1.3 |
sipServicePort |
string |
False |
软电话注册端口 长度限制:number(5) |
1.3.3.1.4 |
sipServiceIp |
string |
False |
软电话注册地址 长度限制:string(50) |
1.3.3.2 |
node2 |
array[object] |
False |
节点2 |
1.3.3.2.1 |
regIPAddress |
string |
False |
注册地址 长度限制:string(50) |
1.3.3.2.2 |
regPort |
string |
False |
注册端口 长度限制:number(5) |
1.3.3.2.3 |
sipServicePort |
string |
False |
软电话注册端口 长度限制:number(5) |
1.3.3.2.4 |
sipServiceIp |
string |
False |
软电话注册地址 长度限制:string(50) |
1.3.4 |
phone |
array[object] |
False |
软电话信息列表 |
1.3.4.1 |
phoneNum |
string |
False |
软电话号码 长度限制:string(32) |
1.3.4.2 |
password |
string |
False |
软电话密码 长度限制:string(50) |
1.3.4.3 |
id |
number |
False |
配置信息Id |
1.3.4.4 |
status |
number |
False |
注册状态,0:已注册,1:暂停状态 |
1.3.4.5 |
remark |
string |
False |
备注信息 |
1.3.4.6 |
tenantId |
string |
False |
租间id |
1.3.4.7 |
partdbId |
string |
False |
分区id |
- 响应状态码: 400
错误的请求:请检查请求路径及参数。
- 响应状态码: 401
未授权:1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值。
错误码
无。
报文样例
请求头:
x-app-key:2******************************8 Authorization:Bearer e******************************5 Content-Type:application/json
请求参数:
{ "offset": "0", "limit": "3" }
响应参数:
{ "retMsg": "successfully", "retCode": "0", "result": { "total": 2, "regPort": "5060", "phone": [{ "phoneNum": "88881196", "password": "****" }, { "phoneNum": "88881197", "password": "****" }], "regIPAddress": "10.162.98.43" } }