- 简介
- 管理平台API
- 开发指南
- 用户身份授权API
- 核心服务API
- 设备信息管理
- 审计日志查询
- 资产信息查询
- 坐席服务管理
- 设备分组管理
- 企业子账号管理
- 硬件API
- 客户端本地API
获取主机列表
GET
https://api.oraydev.cn/sl/v1/remotes
请求参数
Query 参数
keyword
string
搜索关键字
示例值:
00:0C:29:1D:80:CC
keyword_field
string
可选
name
(缺省值,无需传值)、主机名;description
、备注;mac
、MAC地址;ip
、外网IP地址;fastcode
、识别码示例值:
mac
limit
integer
分页容量
示例值:
10
offset
integer
分页记录的位移
示例值:
0
with_info
boolean
是否返回设备信息
with_state
boolean
是否返回设备状态
with_share
boolean
是否返回共享状态
online_status
integer
可选
示例值:
1
sort
string
可选
示例值:
-remote_id
Header 参数
Authorization
string
可选
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.oraydev.cn/sl/v1/remotes?keyword=00:0C:29:1D:80:CC&keyword_field=mac&limit=10&offset=0&with_info=&with_state=&with_share=&online_status=1&sort=-remote_id' \
--header 'Authorization;'
返回响应
🟢200成功
application/json
Headers
Content-Range
string
可选
Body
array of:
client
string
客户端类型
create_time
integer
创建时间
ent_id
integer
可选
hostinfo
object (config.HostInfo)
可选
envs
array[object (config.Env) {4}]
可选
plugins
array[object (config.Plugin) {4}]
可选
info
object (gitlab_orayer_com_sunlogin_microservice_remote_remote.Info)
可选
avatar
string
头像
base_board
string
主板
configmodifiedtime
integer
配置修改时间
contactemail
string
可选
cpu
string
cpu
description
string
备注
description_share
string
可选
disk_drive
string
硬盘
memory
string
内存
name
string
主机名
network_adapter
string
网卡
os
string
系统
os_name
string
设备系统
pc_name
string
设备名
remote_id
integer
主机ID
tag_ids
string
分组ID
version
string
版本
versioncode
string
可选
video_controller
string
显卡
ip
string
可选
is_connected
boolean
是否处于远控状态中
is_granted
boolean
是否是被授权的主机
is_mob_granted
boolean
可选
is_multiple
boolean
是否为批量处理
is_package
boolean
是否定制包相关
is_share
boolean
可选
lan_ip
string
内网IP
license
object (license.License)
可选
account
string
可选
code
string
可选
is_bind
boolean
可选
key
string
可选
level
integer
可选
password
string
可选
remote_id
integer
可选
service_id
integer
可选
user_id
integer
可选
license_code
string
可选
limit_control
string
是否限制控制
mac
string
mac地址
owner_id
integer
主机所有者账号ID
remote_client
object (remote.RemoteClient)
可选
client_id
string
可选
mac
string
可选
remote_id
integer
可选
user_id
integer
可选
remote_id
integer
主机ID
state
object
状态信息
addr
string
主机地址
fastcode
string
识别码
ip
string
IP
login_time
integer
登录时间
new_server
integer
新的被控服务器
origin_server_ip
string
可选
osname
string
系统
owner_id
integer
账号ID
serverip
string
可选
serverip6
string
可选
state
integer
主机状态
svr_version
string
可选
version
string
版本
statuscode
integer
可选
user
object
共享信息
account
string
可选
expiredate
string
可选
host_modules
array[string]
可选
remark
string
可选
remote_id
integer
可选
status
integer
可选
tag_ids
array[integer]
可选
type
integer
可选
user_id
integer
可选
示例
[
{
"client": "string",
"create_time": 0,
"ent_id": 0,
"hostinfo": {
"envs": [
{
"id": "string",
"name": "string",
"param": "string",
"version": "string"
}
],
"plugins": [
{
"id": "string",
"name": "string",
"param": "string",
"version": "string"
}
]
},
"info": {
"avatar": "string",
"base_board": "string",
"configmodifiedtime": 0,
"contactemail": "string",
"cpu": "string",
"description": "string",
"description_share": "string",
"disk_drive": "string",
"memory": "string",
"name": "string",
"network_adapter": "string",
"os": "string",
"os_name": "string",
"pc_name": "string",
"remote_id": 0,
"tag_ids": "string",
"version": "string",
"versioncode": "string",
"video_controller": "string"
},
"ip": "string",
"is_connected": true,
"is_granted": true,
"is_mob_granted": true,
"is_multiple": true,
"is_package": true,
"is_share": true,
"lan_ip": "string",
"license": {
"account": "string",
"code": "string",
"is_bind": true,
"key": "string",
"level": 0,
"password": "string",
"remote_id": 0,
"service_id": 0,
"user_id": 0
},
"license_code": "string",
"limit_control": "string",
"mac": "string",
"owner_id": 0,
"remote_client": {
"client_id": "string",
"mac": "string",
"remote_id": 0,
"user_id": 0
},
"remote_id": 0,
"state": {
"addr": "string",
"fastcode": "string",
"ip": "string",
"login_time": 0,
"new_server": 0,
"origin_server_ip": "string",
"osname": "string",
"owner_id": 0,
"serverip": "string",
"serverip6": "string",
"state": 0,
"svr_version": "string",
"version": "string"
},
"statuscode": 0,
"user": {
"account": "string",
"expiredate": "string",
"host_modules": [
"string"
],
"remark": "string",
"remote_id": 0,
"status": 0,
"tag_ids": [
0
],
"type": 0,
"user_id": 0
}
}
]
🟠400请求有误
修改于 2025-03-25 06:23:38