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

Create Channel

HTTP POSTで新しいチャネルを作成する

要求

HTTPメソッド

POST

URL

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

URLパラメーター

名前	説明
<format>	(必須) HTTP 応答の形式。json または xml として指定します。

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

Bodyパラメーター

名前	説明	値のタイプ
api_key	(必須) プロファイル で確認できるユーザー API キーを指定します。このキーはチャネルAPI キーとは異なります。	string
description	(オプション)要求を行うクライアントの ID または名前を指定します。	string
field1	(オプション) フィールド 1 の名前。	string
fieldX	(オプション) フィールド X の名前。X はフィールド ID です。	string
latitude	(オプション) 緯度（度）。	小数
longitude	(オプション) 経度(度)。	小数
metadata	(オプション)チャネルのメタデータ。JSON、XML、その他のデータを含めることができます。	string
name	(オプション)チャネルの名前。	string
public_flag	(オプション)チャネルが公開されているかどうか。デフォルトは false です。	true または false
tags	(オプション) タグのコンマ区切りリスト。	any
url	(オプション)チャネルの Web ページ URL。	string

Content-Type

application/x-www-form-urlencoded

応答

成功

HTTPステータスコード

200 OK

Body

 JSONの例

POST https://api.thingspeak.com/channels.json api_key=XXXXXXXXXXXXXXXX name=My New Channel

応答 { "id": 4, "name": "My New Channel", "description": null, "metadata": 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": [], "api_keys": [ { "api_key": "XXXXXXXXXXXXXXXX", "write_flag": true } ] }

 XMLの例

POST https://api.thingspeak.com/channels.xml api_key=XXXXXXXXXXXXXXXX name=My New Channel

応答 <?xml version="1.0" encoding="UTF-8"?> <channel> <id type="integer">399673</id> <name>MyChannel</name> <description nil="true"/> <latitude type="decimal">0.0</latitude> <longitude type="decimal">0.0</longitude> <created-at type="dateTime">2018-01-08T22:40:44Z</created-at> <elevation nil="true"/> <last-entry-id type="integer" nil="true"/> <public-flag type="boolean">true</public-flag> <url nil="true"/> <ranking type="integer">30</ranking> <metadata nil="true"/> <license-id type="integer">40512190</license-id> <tags type="array"/> <api-keys type="array"> <api-key> <api-key>XXXXXXXXXXXXXXXX</api-key> <write-flag type="boolean">true</write-flag> </api-key> <api-key> <api-key>XXXXXXXXXXXXXXXX</api-key> <write-flag type="boolean">false</write-flag> </api-key> </api-keys> </channel>

エラー

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

例

POSTMANを使用して新しいパブリックチャネルを作成する

POSTMAN を使用すると、ThingSpeak の RESTful API を使用して HTTP要求を試すことができます。この例では、 POSTMANを使用して新しいチャネルを作成する方法を示します。

次の 3 つの名前付きフィールドを持つ「My チャネル 」というタイトルのチャネルを作成します。「もの」「物」「データ」。public_flag を true に設定して、チャネルを全員と共有します。要求の形式は次のとおりです。

POST https://api.thingspeak.com/channels.json
    api_key=XXXXXXXXXXXXXXXX
    name=My Channel
    public_flag=true
    field1=Stuff
    field=Things
    field3=Data

1. POSTMANで、HTTP 動詞のドロップダウン リストから POST を選択し、アドレス バーに https://api.thingspeak.com/channels.json と入力します。

2. パラメーターapi_key と、Account > My Profile にあるユーザー API キーを入力します。

3. 追加のパラメーターと値を入力します。

   • public_flag、Value: true

   • field1、Value: Stuff

   • field2、Value: Things

   • field3、Value: Data

応答は JSON 形式です。チャネルの作成が成功したことを示すサーバー応答値 200 OK に注意してください。

新しいチャネルは、チャネルページで利用できるようになりました。

参考

関数

• Clear Channel | Delete Channel

トピック

• チャネルプロパティ