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

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

POSTMANで、HTTP 動詞のドロップダウンリストから POST を選択し、アドレスバーに https://api.thingspeak.com/channels.json と入力します。
パラメーターapi_key と、Account > My Profile にあるユーザー API キーを入力します。
追加のパラメーターと値を入力します。
- public_flag、Value: true
- field1、Value: Stuff
- field2、Value: Things
- field3、Value: Data

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

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