Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la versión original en inglés.

Create Channel

Crear nuevo canal con HTTP POST

Pedido

Método HTTP

POST

URL

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

Parámetros de URL

Nombre	Descripción
<format>	(Obligatorio) Formato para la respuesta HTTP, especificado como json o xml.

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

Parámetros del cuerpo

Nombre	Descripción	Tipo de valor
api_key	(Obligatorio) Especifique la clave API de usuario, que puede encontrar en su profile. Esta clave es diferente de las claves API del canal.	cadena
description	(Opcional) Especifique un ID o nombre para el cliente que realiza la solicitud.	cadena
field1	(Opcional) Nombre del campo 1.	cadena
fieldX	(Opcional) Nombre del campo X, donde X es el ID del campo.	cadena
latitude	(Opcional) Latitud en grados.	decimal
longitude	(Opcional) Longitud en grados.	decimal
metadata	(Opcional) Metadatos para el canal, que pueden incluir JSON, XML o cualquier otro dato.	cadena
name	(Opcional) Nombre del canal.	cadena
public_flag	(Opcional) Si el canal es público. El valor predeterminado es falso.	true o false
tags	(Opcional) Lista de etiquetas separadas por comas.	any
url	(Opcional) URL de la página web del canal.	cadena

Tipo de contenido

application/x-www-form-urlencoded

Respuesta

Éxito

Código de estado HTTP

200 OK

Cuerpo

 Ejemplo JSON

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

Respuesta { "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 } ] }

 Ejemplo XML

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

Respuesta <?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>

Error

Para obtener la lista completa, consulte Códigos de error.

Ejemplos

Utilice POSTMAN para crear un nuevo canal público

Puede utilizar POSTMAN para probar sus solicitudes HTTP utilizando la API RESTful para ThingSpeak. Este ejemplo muestra cómo crear un nuevo canal usando POSTMAN.

Cree un canal titulado "Mi canal" con tres campos con nombre: "Cosas", "Cosas" y "Datos". Haga que el canal sea compartido con todos configurando public_flag en true. Aquí está el formato de la solicitud.

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

1. En POSTMAN, seleccione POST de la lista desplegable de verbos HTTP e ingrese https://api.thingspeak.com/channels.json en la barra de direcciones.

2. Ingrese el parámetro api_key y su clave API de usuario, que se encuentra en Account > My Profile.

3. Introduzca los parámetros y valores adicionales:

   • public_flag, Value: true

   • field1, Value: Stuff

   • field2, Value: Things

   • field3, Value: Data

La respuesta está en formato JSON. Tenga en cuenta el valor de respuesta del servidor de 200 OK, lo que indica una creación exitosa del canal.

El nuevo canal ya está disponible en tu página channels .

Consulte también

Funciones

• Clear Channel | Delete Channel

Temas

• Propiedades del canal