Write Settings
Actualizar la configuración del canal con HTTP PUT
Solicitud
Descripción
Use esta solicitud para escribir la configuración del canal. La configuración del canal incluye la descripción del canal, los nombres de los campos, la ubicación del canal, los metadatos, el estado público o privado y el nombre del canal.
Método HTTP
PUT
URL
https://api.thingspeak.com/channels/
<channel_id>
.<format>
Parámetros de URL
Nombre | Descripción |
---|---|
| (Obligatorio) ID de canal para el canal de interés. |
| (Obligatorio) Formato para la respuesta HTTP, especificado como |
Ejemplo: https://api.thingspeak.com/channels/266256.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 perfil. Esta clave es diferente de las claves API del canal. | cadena |
description | (Opcional) Descripción del canal. | cadena |
field1 | (Opcional) Nombre del campo 1. | cadena> |
field<X> | (Opcional) Nombre del campo X, donde X es el ID del campo. | cadena |
latitude | (Opcional) Latitud en grados, especificada como un valor entre | decimal |
longitude | (Opcional) Longitud en grados, especificada como un valor entre | decimal |
elevation | (Opcional) Elevación en metros. | entero |
metadata | (Opcional) Metadatos para el canal, que pueden incluir JSON, XML o cualquier otro dato. | texto |
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. | cadena |
url | (Opcional) URL de la página web del canal. | cadena |
Tipo de contenido
application/x-www-form-urlencoded
Respuesta
Error
Para obtener la lista completa, consulte Códigos de error.
Ejemplos
Use POSTMAN para escribir la configuración del canal
Puedes usar POSTMAN para probar sus solicitudes HTTP utilizando la API RESTful para ThingSpeak. Este ejemplo muestra cómo escribir nuevas configuraciones de canales usando POSTMAN.
Usando un canal existente, cambie el nombre del canal a Updated Channel
y el título del campo 1 para Heart Rate
. También cambie el uso compartido a Público.
PUT https://api.thingspeak.com/channels/CHANNEL_ID api_key=XXXXXXXXXXXXXXXX name=Updated Channel public_flag=true field1=Heart Rate
En POSTMAN, seleccione PUT de la lista desplegable de verbos HTTP e ingrese
api.thingspeak.com/channels/<CHANNEL_ID>.json
en la barra de direcciones, reemplazando<CHANNEL_ID>
con el canal de interés.Introduzca el parámetro
api_key
en la columna de valor, ingrese su clave API de usuario, que se encuentra en Account > My Profile.Introduzca parámetros y valores adicionales:
name
, Value:Updated Channel
field1
, Value:Heart Rate
public_flag
, Value:True
La respuesta está en formato JSON. Tenga en cuenta el valor de respuesta del servidor de 200 OK, lo que indica que se ha escrito correctamente la configuración del nuevo canal.
La nueva configuración de canales ya está disponible en su canales página.
Material adicional
Consulte también
List Your Public Channels
| List Your channels
| List Channels
| Read Settings