Invoke Device Services Asynchronously

Invoke services of a device in an asynchronous manner.

Request URL

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

Request parameters

Table 1. Header Parameters
Parameter Required Type Description
Authorization Yes String The valid access token for making API calls.

The format should be Bearer {access_token}.
Table 2. Path parameters
Parameter Required Type Description
deviceId Yes Integer The unique ID of this device, which is returned when you add the device.
Note: If you did NOT save the deviceID, you can query the device's ID using Search Specific Devices.
Table 3. Body parameters
Parameter Required Type Description
serviceId Yes String The unique ID of the service.
Note: To view the available service IDs of different devices, see Available services.
inputs No Object Input parameters of this service.

Response parameters

Parameter Type Description
status String The result of the API request.
  • Success
  • Failed
requestId String The unique ID of the request, which can be used to quickly locate the request.

Examples

Request example
Reboot the device with device 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": {}
}
Response example
HTTP/1.1 200 OK
{
    "status": "Success",
    "requestId": "4c446ddf993fd3643f5e076498a992b5"
}