在设备列表中定位指定设备ID并发起远控

POST

http://127.0.0.1:12138/locate_host

通过被控端的设备ID 在设备列表中定位设备。
注意：此接口参数值部分需要加密传入，加密过程请参阅：客户端API / 开发指南 / 客户端接口报文加解密流程

请求参数

Header 参数

Authorization

string

必需

访问凭证，参见：服务端API / 获取访问凭证 / 获取客户端API访问凭证

示例值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXRob2QiOiJHRVQiLCJwYXRoIjoiL3JlbW90ZXMiLCJlbnRpZCI6MTcsInVzZXJpZCI6MTIzLCJmdW5jIjpbInVzZXJfYWRkIiwidXNlcl9lZGl0Il0sImlzcyI6Ik9yYXkvU3VubG9naW4iLCJleHAiOjE3MDg0MDY5OTUsImp0aSI6ImZkNGY5OWMzLTAxMjktNGRjYi1iOTEyLWJkODQ0YWE5ZGVlZiJ9.30f-uG50XYWDplkegWnKKgiKnTAuIqW_70UiNGjE810

Body 参数application/x-www-form-urlencoded

remoteid

string

被控设备ID

必需

示例值:

4NbHYtr5XNc1Q8JgIAvuDg==

needcontrol

string

必需

定位到设备时，是否需要拉起远控
1：发起远控，0：不发起远控

示例值:

ygzmv8NMKkABgGHi+e33hQ==

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1:12138/locate_host' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXRob2QiOiJHRVQiLCJwYXRoIjoiL3JlbW90ZXMiLCJlbnRpZCI6MTcsInVzZXJpZCI6MTIzLCJmdW5jIjpbInVzZXJfYWRkIiwidXNlcl9lZGl0Il0sImlzcyI6Ik9yYXkvU3VubG9naW4iLCJleHAiOjE3MDg0MDY5OTUsImp0aSI6ImZkNGY5OWMzLTAxMjktNGRjYi1iOTEyLWJkODQ0YWE5ZGVlZiJ9.30f-uG50XYWDplkegWnKKgiKnTAuIqW_70UiNGjE810' \
--data-urlencode 'remoteid=4NbHYtr5XNc1Q8JgIAvuDg==' \
--data-urlencode 'needcontrol=ygzmv8NMKkABgGHi+e33hQ=='

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

示例

{
  "code": 200,
  "message": "success"
}

修改于 2024-12-23 06:33:24

指定设备ID/识别码发起远控

检测应用程序是否存活