主要内容

本页采用了机器翻译。点击此处可查看最新英文版本。

Delete Channel

使用 HTTP DELETE 删除通道

请求

HTTP 方法

DELETE

URL

https://api.thingspeak.com/channels/<channel_id>.<format>

URL 参数

名称描述

<channel_id>

(必需)感兴趣通道的通道 ID,指定为整数。

<format>

(必需)HTTP 响应的格式,指定为 json 或 xml。

示例: https://api.thingspeak.com/channels/999990.json

主体参数

名称描述值类型
api_key

(必填)指定用户 API 密钥,您可以在个人资料中找到该密钥。此密钥与通道 API 密钥不同。

字符串

Content-Type

application/x-www-form-urlencoded

响应

成功

HTTP 状态代码

200 OK

主体
DELETE https://api.thingspeak.com/channels/4.json
       api_key=XXXXXXXXXXXXXXXX 

响应是通道被删除之前的 JSON 对象,例如:

{
  "id": 4,
  "name": "My New Channel",
  "description": null,
  "latitude": null,
  "longitude": null,
  "created_at": "2014-03-25T13:12:50-04:00",
  "elevation": null,
  "last_entry_id": null,
  "ranking": 15,
  "username": "iothans",
  "tags": []
}
DELETE https://api.thingspeak.com/channels/4.xml
       api_key=XXXXXXXXXXXXXXXX  

响应是通道被删除之前的 XML 对象,例如:

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">4</id>
    <name>My New Channel</name>
    <description nil="true" />
    <latitude type="decimal" nil="true" />
    <longitude type="decimal" nil="true" />
    <created-at type="dateTime">2014-03-25T20:17:44-04:00</created-at>
    <elevation nil="true" />
    <last-entry-id type="integer" nil="true" />
    <ranking type="integer">15</ranking>
    <username>iothans</username>
    <tags type="array" />
</channel>

错误

完整列表请参阅错误代码。

示例

全部展开

您可以使用 POSTMAN 尝试使用 ThingSpeak 的 RESTful API 发出 HTTP 请求。此示例显示如何使用 POSTMAN 清除通道。

这是 HTTP 请求的格式。

DELETE https://api.thingspeak.com/channels/400834.json
       api_key=XXXXXXXXXXXXXXXX

  1. 在 POSTMAN 中,从 HTTP 动词下拉列表中选择 DELETE。

  2. 在地址栏中输入 https://api.thingspeak.com/channels/<channelID>.json,将 <channelID> 替换为您要删除的通道的 ID。

  3. 在 Body 部分下,选择 x-www-form-urlencoded。

  4. 输入参数 api_key 和您的用户 API 密钥,该密钥可以在 Account > My Profile 中找到。

响应是删除前的通道设置的 JSON 对象。