# 查询分配的软电话号码 (V2.0.0) (queryPhone) #### 场景描述 查询分配的软电话号码V2接口。 #### 接口方法 POST #### 接口URI https://域名/apiaccess/CC-Management/v2/mobileAgent/queryPhone，例如域名是service.besclouds.com #### 请求说明 表1请求头参数 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | X-APP-Key | string | False | appKey字段，用户标识 | | 2 | Authorization | string | True | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） | 表2请求体参数 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | limit | string | False | 分页查询时单页最多的记录条数，默认值100，即每页显示100条，非必选 - limit的值大于100则查询100条记录。 - limit的值小于1则查询1条记录。 | | 1 | offset | string | False | 分页查询偏移量，默认值0，即不需要偏移，非必选 | #### 响应说明 - **响应状态码: 200** 表3响应体参数 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 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" } } ```