このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

Read Status of Image Request

HTTP GETで画像要求のステータスを読み取る

最近のイメージ書き込みまたは削除要求のステータスを読み取り、要求が完了したかどうかを確認します。

要求

HTTPメソッド

GET

URL

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

URLパラメーター

名前	説明
<channel_id>	(必須) 関心のあるチャネルのチャネルID。
<request_id>	(必須) 元の要求から返された要求ID。

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

Bodyパラメーター

なし。

ヘッダー

なし。

応答

成功

HTTPステータスコード

200 OK

Body

即時応答は、元の要求ID、現在のコード、およびステータスを含む JSON オブジェクトです。以下に例を示します。

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

可能なステータス値は PENDING、OK、および FAIL です。

ステータスが FAIL の場合、要求失敗の理由が入力される message フィールドもあります。

エラー

完全なリストについては、エラーコード を参照してください。

例

Webブラウザで要求ステータスを読む

Web ブラウザを使用して、ThingSpeak™ の RESTful API へのGET HTTP要求を完了できます。

HTTP 応答の形式を確認するには、このリンクを Web ブラウザにコピーし、チャネルID と要求ID を適宜変更します。

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

cURL で要求ステータスを読み取る

次のコードは Linux^® シェルで動作します。必要に応じてチャネル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を使用して画像要求のステータスを読み取る

Postman を使用すると、ThingSpeak の RESTful API を使用して HTTP DELETE要求を送信できます。この例では、タイムスタンプの範囲内でイメージのセットを削除する方法を示します。

1. Postman で、HTTP 動詞のドロップダウン リストから GET を選択します。

2. アドレスバーに「https://data.thingspeak.com/channels/<channel_id>/recent-requests/<request_id>/status」と入力し、「<channel_id>」を画像チャネルの ID に置き換え、「<request_id>」を問い合わせる要求の要求ID に置き換えます。

3. Params タブと Headers タブには必要なキーはなく、Body の内容は none です。

この画像は、ステータス要求に対する Postman の設定とその結果を示しています。

応答は JSON オブジェクトと、サーバーからの 200 OK です。

参考

Write Image | Delete Image