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

Write Data

Actualizar datos del canal con HTTP GET o POST

Pedido

Método HTTP

POST o GET

URL

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

Parámetros de URL

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

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

Cuerpo

Nombre	Descripción	Tipo de valor
api_key	(Obligatorio) Escriba la clave API para este canal específico. También puede enviar la clave API de escritura mediante un encabezado HTTP THINGSPEAKAPIKEY. La clave de API de escritura se encuentra en la pestaña API Keys de la vista del canal.	cadena
field<X>	(Opcional) Datos del campo X, donde X es el ID del campo	cualquier
lat	(Opcional) Latitud en grados, especificada como un valor entre -90 y 90.	decimal
long	(Opcional) Longitud en grados, especificada como un valor entre -180 y 180.	decimal
elevation	(Opcional) Elevación en metros	entero
status	(Opcional) Mensaje de actualización de estado.	cadena
twitter	(Opcional) Twitter® nombre de usuario vinculado a ThingTweet	cadena
tweet	(Opcional) Twitter actualización de estado	cadena
created_at	(Opcional) Fecha en la que se creó la entrada del feed, en formato ISO 8601 , por ejemplo: 2014-12-31 23:59:59. La fecha que especifiques debe ser única dentro del canal. Las zonas horarias se pueden especificar utilizando el parámetro de zona horaria.	fecha y hora

Tipo de contenido

El tipo de contenido solo es necesario para el método POST, no para el método GET.

application/x-www-form-urlencoded para la mayoría de las actualizaciones.

application/json para actualizaciones en formato JSON.

Respuesta

Éxito

Código de estado HTTP

200 OK

Cuerpo

 Ejemplo de texto

POST https://api.thingspeak.com/update api_key=XXXXXXXXXXXXXXXX field1=73

Respuesta La respuesta es el ID de entrada de la actualización, por ejemplo: 18. Si la actualización falla, la respuesta es 0.

 Ejemplo JSON

POST https://api.thingspeak.com/update.json api_key=XXXXXXXXXXXXXXXX field1=73

La respuesta es un objeto JSON de la nueva entrada, por ejemplo: { "channel_id": 3, "field1": '73', "field2": null, "field3": null, "field4": null, "field5": null, "field6": null, "field7": null, "field8": null, "created_at": '2014-02-25T14:13:01-05:00', "entry_id": 320, "status": null, "latitude": null, "longitude": null, "elevation": null }

 Ejemplo XML

POST https://api.thingspeak.com/update.xml api_key=XXXXXXXXXXXXXXXX field1=73

La respuesta es un objeto XML de la nueva entrada, por ejemplo: <?xml version="1.0" encoding="UTF-8"?> <feed> <channel-id type="integer">3</channel-id> <field1>73</field1> <field2 nil="true"/> <field3 nil="true"/> <field4 nil="true"/> <field5 nil="true"/> <field6 nil="true"/> <field7 nil="true"/> <field8 nil="true"/> <created-at type="dateTime">2014-02-25T14:15:42-05:00</created-at> <entry-id type="integer">321</entry-id> <status nil="true"/> <latitude type="decimal" nil="true"/> <longitude type="decimal" nil="true"/> <elevation nil="true"/> </feed>

Error

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

Limitaciones

Todas las marcas de tiempo deben ser únicas. No puede escribir datos nuevos utilizando marcas de tiempo que coincidan con los datos existentes en el canal.

Ejemplos

Escribir datos con GET

Puede utilizar su navegador web para completar solicitudes GET HTTP a la API RESTful para ThingSpeak™. Tenga en cuenta que para dispositivos integrados o clientes que no codifican automáticamente las solicitudes GET en URL, debe consultar explícitamente los parámetros URL encode antes de realizar la solicitud GET desde el dispositivo.

Copie la URL a la barra de direcciones de su navegador web, cambiando <write_api_key> por su clave API de usuario, que se encuentra en Account > My Profile.

https://api.thingspeak.com/update.json?api_key=<write_api_key>&field1=123

La respuesta es un objeto JSON de la nueva entrada y un 200 OK del servidor.

{
    "channel_id": 266256,
    "created_at": "2018-09-10T17:41:59Z",
    "entry_id": 2,
    "field1": "123",
    "field2": null,
    "field3": null,
    "field4": null,
    "field5": null,
    "field6": null,
    "field7": null,
    "field8": null,
    "latitude": null,
    "longitude": null,
    "elevation": null,
    "status": null
}

Utilice POSTMAN para escribir datos con POST

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

Aquí está el formato de la solicitud HTTP.

POST https://api.thingspeak.com/update.json
       api_key=XXXXXXXXXXXXXXXX
       field1=123

1. En POSTMAN, seleccione POST de la lista desplegable de verbos HTTP.

2. Ingrese https://api.thingspeak.com/update.json en el campo de dirección.

3. Elija x-www-form-urlencoded en la sección Body .

4. Ingrese Parameter api_key y su clave API de escritura, que se encuentra en Channels> API Keys.

5. Ingrese el Parameter field1 y el Value 123.

La respuesta es un objeto JSON de la nueva entrada y un 200 OK del servidor.

Escribir entrada codificada en JSON

Puede utilizar el formato JSON para escribir datos en su canal. Este ejemplo muestra una llamada REST con formato JSON para escribir varios campos e información de estado simultáneamente. La respuesta también tiene formato JSON.

POST api.thingspeak.com/update.json
Content-Type: application/json
 
{ 
        "api_key": "XXXXXXXXXXXXXXXX"  
        "created_at": "2018-04-23 21:36:20 +0200", 
        "field1": "John Johnson", 
        "field3": 56, 
        "field4": 555, 
        "field5": 444, 
        "latitude": "", 
        "longitude": "", 
        "status": "Please check in!" 
    
}

La respuesta es un objeto JSON de la nueva entrada y un 200 OK del servidor.

{
    "channel_id": 12345,
    "created_at": "2018-04-23 21:36:20 +0200", 
    "field1": "John Johnson", 
    "field3": 56, 
    "field4": 555, 
    "field5": 444, 
    "latitude": "", 
    "longitude": "", 
    "status": "Please check in!" 
}

Consulte también

Read Data | Read Field | Read Status | Bulk Write Data

Temas

• Propiedades del canal