Hauptinhalt

Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch zu sehen.

Read Settings

Kanaleinstellungen mit HTTP GET lesen

Anfrage

HTTP-Methode

GET

URL

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

URL-Parameter

NameBeschreibung

<channel_id>

(Erforderlich) Kanal-ID für den gewünschten Kanal.

<format>

(Erforderlich) Format für die HTTP-Antwort, angegeben als json oder xml.

Beispiel: https://api.thingspeak.com/channels/266256.json

Abfragezeichenfolgenparameter

NameBeschreibungWerttyp
api_key

(Erforderlich für private Kanäle) Geben Sie den Benutzer-API-Schlüssel an, den Sie in Ihrem Profil finden. Dieser Schlüssel unterscheidet sich von den Kanal-API-Schlüsseln.

Zeichenfolge

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper
GET https://api.thingspeak.com/channels/9.json

Die Antwort ist ein JSON-Objekt des öffentlichen Kanals 9:

{
  "id": 9,
  "name": "my_house",
  "description": "Netduino Plus connected to sensors around the house",
  "latitude": "40.44",
  "longitude": "-79.9965",
  "created_at": "2010-12-14T01:20:06Z",
  "elevation": "",
  "last_entry_id": 11684395,
  "public_flag': true
  "url": ""
  "ranking": 100,
  "tags": [
    {
      "id": 9,
      "name": "temp"
    },
    {
      "id": 25,
      "name": "light"
    },
    {
      "id": 3,
      "name": "sensor"
    }
  ]
}
GET https://api.thingspeak.com/channels/9.xml

Die Antwort ist ein XML-Objekt des öffentlichen Kanals 9:

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">9</id>
    <name>my_house</name>
    <description> Netduino Plus connected to sensors around the house.</description>
    <latitude type="decimal">40.5</latitude>
    <longitude type="decimal">-79.9965</longitude>
    <created-at type="dateTime">2010-12-14T01:20:06Z</created-at>
    <elevation></elevation>
    <last-entry-id type="integer">11684395</last-entry-id>
    <public_flag>true</public_flag>
    <url></url>
    <ranking type="integer">100</ranking>
    <tags type="array">
       <tag>
          <id type="integer">9</id>
          <name>temp</name>
      </tag>
      <tag>
         <id type="integer">25</id>
         <name>light</name>
      </tag>
      <tag>
         <id type="integer">3</id>
         <name>sensor<name>
      </tag>
    </tags>
</channel>

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Beispiele

Kanaleinstellungen anzeigen

Sie können Ihren Webbrowser verwenden, um GET-HTTP-Anfragen an die RESTful-API für ThingSpeak™ abzuschließen.

Um das Format einer HTTP-Antwort anzuzeigen, kopieren Sie die folgende URL in die Adressleiste Ihres Webbrowsers und ändern Sie <channel_ID> in Ihre Kanal-ID und <XXXXXXXXXXXXXXXX> in Ihren Benutzer-API-Schlüssel, der sich in Account > My Profile befindet.

https://api.thingspeak.com/channels/<channel_ID>.json?api_key=<XXXXXXXXXXXXXXXX>

Die Antwort ist ein JSON-Objekt der Kanaleinstellungen, wie im Antwortabschnitt gezeigt.