分机管理 - 获取分机列表
接口说明
获取用户拥有的分机列表信息。
请求方式
POST,form-data格式
请求参数
| 参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| service | string | 是 | App.Sip_Sipnum.GetSipnumberInfo |
| token | string | 是 | 通过授权接口获取的token |
| status | int | 是 | 分机状态。1:启用(默认)、2:禁用、3:全部 |
| extnumber | string | 否 | 分机号,为空获取所有 |
| currentpage | int | 是 | 页数,默认:1 |
| itemsperpage | int | 是 | 每页数量,默认:100,最小:1;最大:1000 |
接口请求示例(PHP)
<?php
$apiUrl = 'http://127.0.0.1:8080';
$postFields = [
'service' => 'App.Sip_Sipnum.GetSipnumberInfo',
'token' => 'ABCDEFG',
'status' => 3,
'extnumber' => '100001'
];
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $apiUrl);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
$curlError = curl_error($curl);
curl_close($curl);
var_dump($response);
?>
返回数据结构示例
{
"ret": 200,
"data": {
"status": 0,
"desc": "成功",
"result": {
"totalitems": 5,
"currentpage": 1,
"itemsperpage": 100,
"sipusers": [
{
"extnumber": "9002004",
"password": "CNAA9002004",
"username": "9002004",
"status": 1016,
"manualdial": 1,
"record": 1,
"register": null,
"createtime": "2026-09-08 14:47:02",
"updatetime": "2026-09-17 11:43:01",
"message": "坐席已启用"
},
{
"extnumber": "9002005",
"password": "CNAA9002005",
"username": "9002005",
"status": 1016,
"manualdial": 1,
"record": 1,
"register": null,
"createtime": "2026-09-08 14:47:02",
"updatetime": "2026-09-17 11:43:01",
"message": "坐席已启用"
}
]
},
"reqtime": 1789628957,
"rsptime": 1789628957
},
"msg": ""
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| result | object | 分机列表分页信息 |
| -totalitems | int | 分机总数 |
| -currentpage | int | 当前页码 |
| -itemsperpage | int | 每页默认值 |
| -sipusers | array | 分机列表数组 |
| —extnumber | string | 分机号 |
| —password | string | 分机号登陆密码 |
| —status | int | 分机状态码,1016:启用、1013:禁用 |
| —register | string | 分机号注册状态。nreg:未注册;reg:已注册 |
| —manualdial | int | 直拨状态,1:启用、2:禁用 |
| —record | int | 录音状态,1:启用、2:禁用 |