Write Settings
Actualizar la configuración del canal con HTTP PUT
Pedido
Descripción
Utilice 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 profile. 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
Utilice POSTMAN para escribir la configuración del canal
Puede utilizar POSTMAN para probar sus solicitudes HTTP utilizando la API RESTful para ThingSpeak. Este ejemplo muestra cómo escribir nuevas configuraciones de canal usando POSTMAN.
Usando un canal existente, cambie el nombre del canal a Updated Channel
y el título del campo 1 a 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.Ingrese 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 una escritura exitosa de la nueva configuración del canal.
La nueva configuración del canal ahora está disponible en su página channels .
Material adicional
Consulte también
List Your Public Channels
| List Your channels
| List Channels
| Read Settings