Read Status of Image Request

使用 HTTP GET 读取图像请求的状态

读取最近的图像写入或删除请求的状态，以便您可以确定请求是否已完成。

请求

GET

https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status

名称	描述
`<channel_id>`	（必需）感兴趣的通道的通道 ID。
`<request_id>`	（必填）请求 ID，从原始请求返回。

示例： https://data.thingspeak.com/channels/0987654321/recent-requests/cl2th2wxyuvtsr7m9e3l5blje/status

没有任何。

没有任何。

HTTP 状态代码

200 OK

主体

立即响应是一个 JSON 对象，其中包含原始请求ID 及其当前代码和状态。示例：

{
    "requestID": "cl2th2wxyuvtsr7m9e3l5blje",
    "code": 1,
    "status": "OK"
}

可能的状态值为 PENDING、OK 和 FAIL。

如果状态为 FAIL，则还有一个 message 字段，其中填充了请求失败的原因。

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

您可以使用 Web 浏览器完成对 ThingSpeak™ 的 RESTful API 的 GET HTTP 请求。

要查看 HTTP 响应的格式，请将此链接复制到您的 Web 浏览器，并根据需要更改通道ID 和请求ID。

https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status

以下代码在 Linux^® shell 中运行。根据需要更改通道ID请求ID。

curl --location --request GET 'https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status'

原始响应类似于：

{"requestID":"cl2tgo098765432193z93gpc1","code":1,"status":"OK"}

您可以使用 Postman 使用 ThingSpeak 的 RESTful API 发送 HTTP DELETE 请求。此示例演示如何删除时间戳范围内的一组图像。

在 Postman 中，从 HTTP 动词的下拉列表中选择 GET。
在地址栏中输入https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status，其中<channel_id>替换为图像通道的ID，<request_id>替换为图像通道的请求ID您正在询问的请求。
Params和Headers选项卡下不需要按键，Body内容为none 。

此图显示了状态请求的 Postman 设置及其结果。

Postman status request