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

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 キーを指定します。これはprofileにあります。このキーはチャネルAPI キーとは異なります。	文字列
description	(オプション)要求を行うクライアントの ID または名前を指定します。	文字列
field1	(オプション) フィールド 1 の名前。	文字列
fieldX	(オプション) フィールド X 名。X はフィールド ID です。	文字列
latitude	(オプション) 度単位の緯度。	10進数
longitude	(オプション) 度単位の経度。	10進数
metadata	(オプション)チャネルのメタデータ。JSON、XML、またはその他のデータを含めることができます。	文字列
name	(オプション)チャネルの名前。	文字列
public_flag	(オプション)チャネルがパブリックかどうか。デフォルトは false です。	trueまたはfalse
tags	(オプション) タグのカンマ区切りリスト。	any
url	(オプション)チャネルの Web ページ URL。	文字列

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とユーザー API キーを入力します。これはAccount > My Profileにあります。

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

   • public_flag、 Value:true

   • field1、 Value:Stuff

   • field2、 Value:Things

   • field3、 Value:Data

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

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

参考

関数

• Clear Channel | Delete Channel

トピック

• チャネルのプロパティ