请求示例 HTTP的示例 PUT /controller/campus/v1/accountservice/mac/a91e1696-02a2-4a68-bad4-aa639359c8cf 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 { "name" : "macAccountName", "description" : "mac test", "terminalMacs" : ["11-11-11-11-11-11","22-22-22-22-22-22"], "userGroupId" : "a7953ba5-2779-4fb4-aaf0-6f39fac19c5e", "roleIds" : ["a7953ba5-2779-4fb4-aaf0-6f39fac19c5e"], "email" : "xxx@example.com", "telephone" : "1xxxxxxxxxx", "validPeriodLong" : "1571710215000", "bindAccessInfo" : { "bindDeviceInfo" : [ { "deviceIp" : "10.1.1.1", "port" : "G0/0/1", "vlan" : "3377" } ], "bindAccDeviceInfo" : [ { "deviceIp" : "10.1.1.1", "port" : "G0/0/1", "vlan" : "3377" } ], "bindEsn" : "21500829352SH1903955,21500829352SH1903977", "bindIP" : "10.1.1.1,10.1.1.2" }, "fields" : [ { "customFieldId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359cb", "customFieldValue" : "aaa" } ], "supportDpsk" : false, "dpsk" : "" }

响应示例 返回状态码为200：修改成功，响应体参考DataMacDto。 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" : "", "data" : { "name" : "macAccountName", "description" : "mac test", "terminalMacs" : ["11-11-11-11-11-11","22-22-22-22-22-22"], "userGroupId" : "a7953ba5-2779-4fb4-aaf0-6f39fac19c5e", "roleIds" : ["a7953ba5-2779-4fb4-aaf0-6f39fac19c5e"], "email" : "xxx@example.com", "telephone" : "1xxxxxxxxxx", "validPeriodLong" : "1571710215000", "bindAccessInfo" : { "bindDeviceInfo" : [ { "deviceIp" : "10.1.1.1", "port" : "G0/0/1", "vlan" : "3377" } ], "bindAccDeviceInfo" : [ { "deviceIp" : "10.1.1.1", "port" : "G0/0/1", "vlan" : "3377" } ], "bindEsn" : "21500829352SH1903955,21500829352SH1903977", "bindIP" : "10.1.1.1,10.1.1.2" }, "fields" : [ { "customFieldId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359cb", "customFieldValue" : "aaa" } ], "supportDpsk" : false, "dpsk" : "", "id" : "d50a4732-f933-410b-88c0-7adf0ba59550", "userGroupPath" : "ROOT\\Guest" } } 返回状态码为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 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error 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/mac/action/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 { "ids" : ["fb9317cf-fdb6-40fe-821f-3c20fc6a63eb"] }

响应示例 返回状态码为200：删除成功，响应体参考DeleteMacsOutput。 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 { "errorCode" : "", "errorMessage" : "", "deleteNameList" : ["name"], "failList" : [ { "errcode" : "0308000221", "errmsg" : "The selected user does not exist", "id" : "51cdcbe3-5e14-492b-ab27-86950b661d19", "name" : "mac1" } ] } 返回状态码为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 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error 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

响应示例 返回状态码为201：创建mac帐号成功，响应体参考DataMacDto。 HTTP/1.1 201 Created 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" : "", "data" : { "name" : "macAccountName", "description" : "mac test", "terminalMacs" : ["11-11-11-11-11-11","22-22-22-22-22-22"], "userGroupId" : "a7953ba5-2779-4fb4-aaf0-6f39fac19c5e", "roleIds" : ["a7953ba5-2779-4fb4-aaf0-6f39fac19c5e"], "email" : "xxx@example.com", "telephone" : "1xxxxxxxxxx", "validPeriodLong" : "1571710215000", "bindAccessInfo" : { "bindDeviceInfo" : [ { "deviceIp" : "10.1.1.1", "port" : "G0/0/1", "vlan" : "3377" } ], "bindAccDeviceInfo" : [ { "deviceIp" : "10.1.1.1", "port" : "G0/0/1", "vlan" : "3377" } ], "bindEsn" : "21500829352SH1903955,21500829352SH1903977", "bindIP" : "10.1.1.1,10.1.1.2" }, "fields" : [ { "customFieldId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359cb", "customFieldValue" : "aaa" } ], "supportDpsk" : false, "dpsk" : "", "id" : "d50a4732-f933-410b-88c0-7adf0ba59550", "userGroupPath" : "ROOT\\Guest" } } 返回状态码为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 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error 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/mac 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 { "name" : "macAccountName", "description" : "mac test", "terminalMacs" : ["11-11-11-11-11-11","22-22-22-22-22-22"], "userGroupId" : "a7953ba5-2779-4fb4-aaf0-6f39fac19c5e", "roleIds" : ["a7953ba5-2779-4fb4-aaf0-6f39fac19c5e"], "email" : "xxx@example.com", "telephone" : "1xxxxxxxxxx", "validPeriodLong" : "1571710215000", "bindAccessInfo" : { "bindDeviceInfo" : [ { "deviceIp" : "10.1.1.1", "port" : "G0/0/1", "vlan" : "3377" } ], "bindAccDeviceInfo" : [ { "deviceIp" : "10.1.1.1", "port" : "G0/0/1", "vlan" : "3377" } ], "bindEsn" : "21500829352SH1903955,21500829352SH1903977", "bindIP" : "10.1.1.1,10.1.1.2" }, "fields" : [ { "customFieldId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359cb", "customFieldValue" : "aaa" } ], "supportDpsk" : false, "dpsk" : "" }