-
响应示例 返回状态码为200：修改成功信息，响应体参考MobileTerminalUpdateResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : ""
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 modifyParam 是 REFERENCE 详细请参见表2。 待修改的终端信息。 - 表2 MobileTerminalUpdateDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 imei 否 string 0~20个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 终端唯一标识。 "990000862471854" imsi 否 string 0~20个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 SIM卡唯一标识，该参数传值时，请填写10-20位数字。 "990000862471854" terminalContent 否 REFERENCE 详细请参见表3。 终端信息。 -
-
响应参数 返回状态码为200：修改成功信息，响应体参考MobileTerminalUpdateResponse。 表3 MobileTerminalUpdateResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。
-
请求示例 HTTP的示例 PUT /controller/campus/v1/accountservice/terminalmgr/mobile/endpoint HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-AC
CES S-TOKEN: x-yyyyyy
{
"imei" : "990000862471854",
"imsi" : "990000862471854",
"terminalContent" : {
"imsi" : "460030912121001",
"imei" : "990000862471854",
"msisdn" : "11111111111",
"authorIpv4" : "192.168.10.1",
"authorIpv6" : "FC00::1101/64",
"terminalGroupId" : "22fbb5f2-d07e-4710-94ac-7705517ab842",
"isBlocked" : false,
"description" : "Huawei phone"
}
}
-
响应示例 返回状态码为200：强制下线返回结果，响应体参考MobileTerminalOfflineResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "",
"successList" : ["460030912121001"],
"failList" : [
{
"errcode" : "0x022b0006",
"errmsg" : "no rights",
"imei" : "990000862471854",
"imsi" : "990000862471854"
}
]
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求示例 HTTP的示例 POST /controller/campus/v1/accountservice/terminalmgr/mobile/offline HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
"imeis" : ["460030912121001"]
}
-
响应参数 返回状态码为200：查询成功的信息，响应体参考MobileTerminalListDto。 表3 MobileTerminalListDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" pageIndex int32 - - 位于查询记录第几页。 1 pageSize int32 - - 一页里查询记录的数量。 10 totalRecords int32 - - 查询记录总条数。 30 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表5。 终端详细信息列表。 - 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200：查询成功的信息，响应体参考MobileTerminalListDto。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "",
"pageIndex" : 1,
"pageSize" : 10,
"totalRecords" : 30,
"data" : [
{
"id" : "62008e2c-6bf2-48ea-a17c-d278c594d83a",
"imsi" : "460030912121001",
"imei" : "990000862471854",
"msisdn" : "11111111111",
"authorIpv4" : "192.168.10.1",
"authorIpv6" : "FC00::1101/64",
"terminalGroupId" : "22fbb5f2-d07e-4710-94ac-7705517ab842",
"isBlocked" : false,
"description" : "Huawei phone"
}
]
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求示例 HTTP的示例 POST /controller/campus/v1/accountservice/terminalmgr/mobile/endpoint/list HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
"pageIndex" : 1,
"pageSize" : 20,
"imei" : "990000862471854",
"imsi" : "460030912121001",
"terminalGroupId" : "22fbb5f2-d07e-4710-94ac-7705517ab842",
"isBlocked" : false,
"msisdn" : "11111111111",
"authorIpv4" : "192.168.10.1",
"authorIpv6" : "FC00::1101/64"
}
-
请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 queryParam 是 REFERENCE 详细请参见表2。 待查询终端的信息。 - 表2 MobileTerminalSelectDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 是 int32 [1-2147483647] 1 查询的页码。 1 pageSize 是 int32 [1-1000] 10 每页查询终端的数量。 20 imei 否 string 0~20个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 终端唯一标识，imei和imsi不填写时查询终端组下所有终端。。 "990000862471854" imsi 否 string 0~20个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 SIM卡唯一标识，该参数传值时，请填写10-20位数字。 "460030912121001" terminalGroupId 是 string 32~36个字符。 - 自定义终端组ID。uuid格式 "22fbb5f2-d07e-4710-94ac-7705517ab842" isBlocked 否 boolean true false false 是否加入黑名单，处于黑名单的终端无法认证。默认值为false。 false msisdn 否 string 0~128个字符。 - 该字段可能包含敏感信息和个人数据，请妥善做好保护。 终端的msisdn，只能是数字或者以+开头的数字。 "11111111111" authorIpv4 否 string 0~20个字符。 - 终端ip，只支持IPv4地址。 "192.168.10.1" authorIpv6 否 string 0~128个字符。 - 终端IPv6地址，可以带前缀长度 "FC00::1101/64"
-
响应示例 返回状态码为200：删除成功信息，响应体参考MobileTerminalDeleteResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "",
"successList" : ["460030912121001"],
"successImsiList" : ["460030912121001"],
"failList" : [
{
"errcode" : "0x022b0006",
"errmsg" : "no rights",
"imei" : "990000862471854",
"imsi" : "990000862471854"
}
]
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求示例 HTTP的示例 POST /controller/campus/v1/accountservice/terminalmgr/mobile/endpoint/batch-delete HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
"deleteImeis" : ["460030912121001"],
"deleteImsis" : ["460030912121001"]
}
