Release History
Introduction
Security Overview
Getting Started
User Guide
API Reference
- Overview
  Milesight Development Platform offers Application Programming Interfaces (APIs) that allow you to integrate the system with third-party applications. Using the Milesight Development Platform API, third-party applications can access and manage resources within Milesight Development Platform, which helps you to implement workflow automation between systems and increase customization options in your own applications.
- API Introduction
  - API Request
  - API Interface List
    This topic provides a summary list of Milesight Development Platform API interfaces.
  - Featured APIs
    - Authentication
    - Device Management
      - Add a Device
        Add a device to Milesight Development Platform and associate it with the current Application.
      - Search Specific Devices
        Search specific devices from all the devices that are associated with the current Application.
      - Query a Specific Device
        Query the detailed information of a specific device.
      - Query the TSL Model of a Device
        Query the TSL (Thing Specification Language) model of a device.
      - Query the Historical Data of Properties Reports
        After a device is added to the Milesight Development Platform, it periodically reports property data to the platform, such as current status, collected data, and more. This topic introduces the interface for querying the historical data of device properties reports.
      - Invoke Device Services Asynchronously
        Invoke services of a device in an asynchronous manner.
      - Update a Device Information
        Update the device's name, description and tag.
      - Update Device Properties Incrementally
        Update the properties of a device incrementally. This is suitable for single device and simple parameters updates.
      - Delete a Device
        Delete a device from Milesight Development Platform.
      - Getting the Configuration of a Specific Device
        Query the detailed configuration of a specific device.
    - RPS Management
    - Task Management
- Webhook Event Notification
Device Reference
FAQ
Feedback

Delete a Device

Delete a device from Milesight Development Platform.

Request URL

DELETE {base_url}/device/openapi/v1/devices/{deviceId}

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	Long	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.

Response Parameters


Parameter	Type	Description
data	String	The SN (Serial Number) of the deleted device.
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

Delete the device with ID "1739930666380779522"

DELETE /device/openapi/v1/devices/1739930666380779522 HTTP/1.1
Host: demo.milesight.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json

Response example

HTTP/1.1 200 OK
{
    "data": "6791D1970467xxxx",
    "status": "Success",
    "requestId": "1646ae38d53b3be251eda05c2245885f"
}