更新时间：2025-04-30 15:49:32

文档内容

通过mac查询盒子

路由

https://open.aaacdn.cn/api/auth/box/mac/{mac}

method

GET

请求参数

参数名称参数类型参数说明
tokenstring必需附加在url中传送,调用api_token获得,时效为一次性，调用完后销毁
macstringmac地址，路由的一部分,如 bc24119d1f41

返回示例

{"code":200,"msg":"操作成功","data":[{"id":"mac1741859275504","arch":"arm","boxType":"default","createTime":"2025-03-13 17:48:15","lastLoginTime":"2025-03-26 08:28:37","status":0,"mac":"d0:a4:6f:37:b7:03","mem":"","platform":"arm","os":"android","natType":"NAT3","areaType":"all","network":"110.187.118.49","isp":"电信","city":"达州","province":"四川","country":"中国","cityArea":"","virtual":0,"online":0,"disk":"[{"Path":"/","All":"1.2G","Free":"484M"},{"Path":"/dev","All":"0.9G","Free":"0.9G"},{"Path":"/mnt","All":"0.9G","Free":"0.9G"},{"Path":"/odm","All":"124M","Free":"123M"},{"Path":"/product","All":"124M","Free":"120M"},{"Path":"/vendor","All":"744M","Free":"497M"},{"Path":"/data","All":"53G","Free":"1.9G"},{"Path":"/cache","All":"1.0G","Free":"1.0G"},{"Path":"/metadata","All":"11M","Free":"11M"},{"Path":"/mnt/vendor/param","All":"11M","Free":"11M"},{"Path":"/mnt/vendor/tee","All":"27M","Free":"27M"},{"Path":"/mnt/runtime/default/emulated","All":"53G","Free":"1.9G"}]","memory":"{"All":2055192,"Alls":"1.9G","Free":983716,"Frees":"0.9G"}","ipInterface":"[{"Index":1,"Name":"lo","IpAddr":["127.0.0.1/8","::1/128"],"Mac":"","Mtu":65536,"Alive":true,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":2,"Name":"eth0","IpAddr":null,"Mac":"80:24:11:27:05:3a","Mtu":1500,"Alive":true,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":3,"Name":"tunl0","IpAddr":null,"Mac":"","Mtu":1480,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":4,"Name":"ip_vti0","IpAddr":null,"Mac":"","Mtu":1480,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":5,"Name":"ip6_vti0","IpAddr":null,"Mac":"","Mtu":1500,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":6,"Name":"sit0","IpAddr":null,"Mac":"","Mtu":1480,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":7,"Name":"ip6tnl0","IpAddr":null,"Mac":"","Mtu":1452,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":8,"Name":"wlan0","IpAddr":["192.168.2.6/24","240e:39e:6f30:10c0:2527:2f52:2703:438f/64","240e:39e:6f30:10c0:d2a4:6fff:fe37:b703/64","fe80::d2a4:6fff:fe37:b703/64"],"Mac":"d0:a4:6f:37:b7:03","Mtu":1500,"Alive":true,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false}]","version":"2.2.6"}]}

返回参数说明

参数名称参数类型参数说明
idstring盒子ID ,唯一
archstring盒子系统架构,amd64,arm64,arm
boxTypestring盒子类型,一般盒子(default)，路由器(router)
createTimestring盒子绑定时间,2024-12-07 17:53:25
lastLoginTimestring最后登陆时间,2025-04-07 15:45:49
macstringmac地址,c8:fe:0f:37:04:b4
memstring用户自定义备注
platformstring平台,x86或arm
osstring系统类型,android或linux
natTypestringnat类型,NAT1,NAT2,NAT3,NAT4或错误
areaTypestring盒子默认的业务区域业型,all(全国),或sp(省内)
networkstring公网ip
ispstring运营商,电信，移动，联通
citystring盒子所在的城市,如：南昌
provincestring省份
countrystring国家
cityAreastring所在城市小区，如：青山湖区
virtualint是否为虚拟节点,1为是，0为非
onlineint是否在线,1为在线，0为不在线
diskstring磁盘信息,是一个json数组
memorystring内存信息,是一个json对象
ipInterfacestring网卡信息，是一个json数组
versionstring盒子版本号,如:2.3.4

#### 返回的磁盘信息

[{"Path":"/","All":"1.2G","Free":"484M"},{"Path":"/dev","All":"0.9G","Free":"0.9G"},{"Path":"/mnt","All":"0.9G","Free":"0.9G"},{"Path":"/odm","All":"124M","Free":"123M"},{"Path":"/product","All":"124M","Free":"120M"},{"Path":"/vendor","All":"744M","Free":"497M"},{"Path":"/data","All":"53G","Free":"2.0G"},{"Path":"/cache","All":"1.0G","Free":"1.0G"},{"Path":"/metadata","All":"11M","Free":"11M"},{"Path":"/mnt/vendor/param","All":"11M","Free":"11M"},{"Path":"/mnt/vendor/tee","All":"27M","Free":"27M"},{"Path":"/mnt/runtime/default/emulated","All":"53G","Free":"2.0G"}]

磁盘参数说明
参数名称参数类型参数说明
Pathstring挂载的目录,/data
Allstring总大小,如:1.9G
Freestring空闲大小,如:1G

返回的网卡信息

json数据,[{"Index":1,"Name":"lo","IpAddr":["127.0.0.1/8","::1/128"],"Mac":"","Mtu":65536,"Alive":true,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":2,"Name":"eth0","IpAddr":null,"Mac":"80:24:11:27:04:30","Mtu":1500,"Alive":true,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":3,"Name":"tunl0","IpAddr":null,"Mac":"","Mtu":1480,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":4,"Name":"ip_vti0","IpAddr":null,"Mac":"","Mtu":1480,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":5,"Name":"ip6_vti0","IpAddr":null,"Mac":"","Mtu":1500,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":6,"Name":"sit0","IpAddr":null,"Mac":"","Mtu":1480,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":7,"Name":"ip6tnl0","IpAddr":null,"Mac":"","Mtu":1452,"Alive":false,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false},{"Index":8,"Name":"wlan0","IpAddr":["192.168.1.5/24","2408:824e:192c:c5e0:242b:b47c:1304:58b9/64","2408:824e:192c:c5e0:cafe:fff:fe37:4b4/64","fe80::cafe:fff:fe37:4b4/64"],"Mac":"c8:fe:0f:37:04:b4","Mtu":1500,"Alive":true,"Broadcast":false,"Loopback":false,"PointToPoint":false,"Multicast":false}]

参数名称参数类型参数说明
Indexint数组序列号,只做排序使用
Namestring网卡名称,如eth0
IpAddrarray网卡绑定的ip,如:["192.168.3.60/24","fe80::be24:11ff:fe9d:1f41/64"]
Macstringmac地址,如:bc:24:11:9d:1f:41
Mtuint网卡的标志位
Aliveboolean是否启用（mut标志位延伸）
Broadcastboolean未使用标志位字段（mut标志位延伸）
Loopbackboolean未使用标志位字段（mut标志位延伸）
PointToPointboolean未使用标志位字段（mut标志位延伸）
Multicastboolean未使用标志位字段（mut标志位延伸）

返回的内存信息

{"All":2055192,"Alls":"1.9G","Free":128892,"Frees":"0.1G"}

参数名称参数类型参数说明
Allint64内存总大小
Freeint64空闲大小