Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

Write Data

Mettre à jour les données du canal avec HTTP GET ou POST

Requête

Méthode HTTP

POST ou GET

URL

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

Paramètres d'URL

Nom	Description
<format>	(Obligatoire) Format de la réponse HTTP, spécifié comme étant vide, json ou xml.

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

Corps

Nom	Description	Type de valeur
api_key	(Obligatoire) Écrivez la clé API pour ce canal spécifique . Vous pouvez également envoyer la clé d'API en écriture à l'aide d'un en-tête HTTP THINGSPEAKAPIKEY. La clé API d'écriture se trouve dans l'onglet API Keys de la vue des canaux.	chaîne de caractère
field<X>	(Facultatif) Données du champ X, où X est l'ID du champ	n'importe quel
lat	(Facultatif) Latitude en degrés, spécifiée comme une valeur comprise entre -90 et 90.	décimal
long	(Facultatif) Longitude en degrés, spécifiée comme une valeur comprise entre -180 et 180.	décimal
elevation	(Facultatif) Altitude en mètres	entier
status	(Facultatif) Message de mise à jour du statut.	chaîne de caractère
twitter	(Facultatif) Twitter® nom d'utilisateur lié à ThingTweet	chaîne de caractère
tweet	(Facultatif) Mise à jour du statut Twitter	chaîne de caractère
created_at	(Facultatif) Date de création de l'entrée de flux, au format ISO 8601, par exemple : 2014-12-31 23:59:59. La date que vous spécifiez doit être unique dans le canal. Les fuseaux horaires peuvent être spécifiés à l'aide du paramètre timezone.	date-heure

Type de contenu

Content-Type est requis uniquement pour la méthode POST, pas pour la méthode GET.

application/x-www-form-urlencoded pour la plupart des mises à jour.

application/json pour les mises à jour au format JSON.

Réponse

Succès

Code HTTP Status

200 OK

Corps

 Exemple de texte

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

Réponse La réponse est l'ID d'entrée de la mise à jour, par exemple : 18. Si la mise à jour échoue, la réponse est 0.

 Exemple JSON

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

La réponse est un objet JSON de la nouvelle entrée, par exemple : { "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 }

 Exemple XML

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

La réponse est un objet XML de la nouvelle entrée, par exemple : <?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>

Erreur

Pour la liste complète, voir Codes d'erreur.

Limites

Tous les horodatages doivent être uniques. Vous ne pouvez pas écrire de nouvelles données en utilisant des horodatages qui correspondent aux données existantes dans le canal.

Exemples

Écrire des données avec GET

Vous pouvez utiliser votre navigateur Web pour effectuer des requêtes HTTP GET à l'API RESTful pour ThingSpeak™. Notez que pour les appareils ou clients intégrés qui n'encodent pas automatiquement les requêtes GET, vous devez explicitement URL encode paramètres de requête avant d'effectuer la requête GET à partir de l' appareil.

Copiez l'URL dans la barre d'adresse de votre navigateur Web, en remplaçant <write_api_key> par votre clé API utilisateur, qui se trouve dans Account > My Profile. $.

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

La réponse est un objet JSON de la nouvelle entrée et un 200 OK du serveur.

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

Utiliser POSTMAN pour écrire des données avec POST

Vous pouvez utiliser POSTMAN pour tester vos requêtes HTTP à l'aide de l'API RESTful pour ThingSpeak. Cet exemple montre comment écrire des données sur un canal à l'aide de POSTMAN.

Voici le format de la requête HTTP.

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

1. Dans POSTMAN, sélectionnez POST dans la liste déroulante des verbes HTTP.

2. Saisissez https://api.thingspeak.com/update.json dans le champ d'adresse.

3. Choisissez x-www-form-urlencoded dans la section Body.

4. Entrez le Parameter api_key et votre clé API d'écriture, qui se trouve dans Channels> API Keys.

5. Entrez le Parameter field1 et le Value 123.

La réponse est un objet JSON de la nouvelle entrée et un 200 OK du serveur.

Écrire une entrée codée JSON

Vous pouvez utiliser le format JSON pour écrire des données sur votre canal. Cet exemple montre un appel REST au format JSON pour écrire simultanément plusieurs champs et informations d'état. La réponse est également au format 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 réponse est un objet JSON de la nouvelle entrée et un 200 OK du serveur.

{
    "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!" 
}

Voir aussi

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

Rubriques

• Propriétés du canal