Main Content

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

Add TalkBack Command

Ajouter la commande Talkback à la file d'attente Talkback

développer tous les éléments de la page

Requête

Méthode HTTP

POST

URL

https://api.thingspeak.com/talkbacks/<talkback_id>/commands.<format>

Arguments d'entrée

NomDescription

<talkback_id>

(Obligatoire) ID Talkback , spécifié sous la forme d'un entier positif.

<format>

Format de la réponse HTTP, spécifié comme json ou xml.

Exemple : https://api.thingspeak.com/talkbacks/12345/commands

Paramètres du corps de la requête

NomDescriptionType de valeur
api_key

(Obligatoire) clé d'API pour cette instance spécifique de Talkback. La clé Talkback est différente des clés d'API de canal et d'utilisateur.

chaîne de caractère

command_string

Commande à envoyer à votre appareil. Chaque command_string est limité à 255 caractères.

chaîne de caractère

position

(Facultatif) La position dans laquelle vous souhaitez que la commande apparaisse. Toutes les commandes précédentes à ou après cette position sont décalées vers le bas. Si la position est laissée vide, la commande est automatiquement ajoutée à la fin de la file d'attente avec la position la plus élevée.

entier

Type de contenu

application/x-www-form-urlencoded

Réponse

Succès

Code HTTP status

200 OK

Corps

 Exemple de texte

 Exemple JSON

 Exemple XML

Erreur

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

Exemples

développer tout

Vous pouvez utiliser POSTMAN pour tester vos requêtes HTTP à l'aide de l'API RESTful pour ThingSpeak. Cet exemple montre comment ajouter une commande Talkback à une file d'attente existante à l'aide de POSTMAN.

Ajoutez la commande Talkback LIGHTON à une file d'attente Talkback existante avec l'ID Talkback 24507.

POST https://api.thingspeak.com/talkbacks/24507/commands
     api_key=YOUR_TALKBACK_API_KEY
     command_string=LIGHTON

  1. Dans POSTMAN, sélectionnez POST dans la liste déroulante des verbes HTTP et saisissez https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands dans la barre d'adresse. Remplacez TALKBACK_ID par votre identifiant Talkback .

  2. Entrez le paramètre api_key et votre clé d'API Talkback , qui se trouve dans Apps > TalkBack> YOUR TALKBACK NAME.

  3. Saisissez les paramètres et valeurs supplémentaires :

    • api_key, Value : XXXXXXXXXXXXXXXX

    • command_string, Value : LIGHTON

La réponse est au format texte. Notez la valeur de réponse du serveur de 200 OK, qui indique l'ajout réussi de la commande à votre file d'attente Talkback .

La nouvelle commande est maintenant disponible dans votre file d'attente Talkback .

Voir aussi

Fonctions

Rubriques