异步调用设备服务

以异步方式调用设备的服务。

请求URL

POST {base_url}/device/openapi/v1.0/devices/{deviceId}/services/call

请求参数

表 1. 头部参数
参数 是否必填 类型 描述
Authorization 是 String API调用的有效访问token。

格式为 Bearer {access_token}。
表 2. 路径参数
参数 是否必填 类型 描述
deviceId 是 Integer 设备的唯一标识符，当您添加设备时会返回。
注： 如果您没有保存设备ID，可以使用以下方法查询设备的ID 查询设备列表。
表 3. 主体参数
参数 是否必填 类型 描述
serviceId 是 String 设备唯一的可用服务ID。
注： 查看设备可能的服务ID可以查看 可用服务.
inputs 否 Object 该服务的输入参数。

响应参数

参数 类型 描述
status String API的请求结果。
  • Success
  • Failed
requestId String 唯一的请求ID ,可用于快速定位请求。

示例

请求示例
重新启动设备ID为"1748256426492760066"的设备。
POST /device/openapi/v1.0/devices/1748256426492760066/services/call HTTP/1.1
Host: milesight.demo.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json
User-Agent: OpenAPI

{
    "serviceId": "reboot",
    "inputs": {}
}
响应示例
HTTP/1.1 200 OK
{
    "status": "Success",
    "requestId": "4c446ddf993fd3643f5e076498a992b5"
}