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.
      - Create a Remote Access Channel
        Create an available remote access channel for a specific device.
      - Query Remote Access Channels
        Query the available remote access channels of a specific device.
      - Delete a Remote Access Channel
        Delete an existing remote access channel of a specific device.
    - RPS Management
    - Task Management
- Webhook Event Notification
Device Reference
FAQ
Feedback

Delete a Remote Access Channel

Delete an existing remote access channel of a specific device.

Request URL

DELETE {base_url}/device/openapi/v1/devices/{deviceId}/remote-access-channels/{channelToken}

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.
channelToken	Yes	String	The token of the remote access channel to be deleted. You can obtain it through the Query Remote Access Channels API.

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.

Note: No data field is returned for this API.

Examples

Request example

Delete the remote access channel with the token "f8a2c9e14d7b4036a1e5c2d8f90b3a7c" of the device with ID "1737007595605147649".

DELETE /device/openapi/v1/devices/1737007595605147649/remote-access-channels/f8a2c9e14d7b4036a1e5c2d8f90b3a7c HTTP/1.1
Host: demo.milesight.com
Authorization: Bearer {access_token}

Response example

HTTP/1.1 200 OK

{
    "status": "Success",
    "requestId": "9d3c71b0e2f84a56b7c8d1e0f4a5b6c7"
}