Contenu principal

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

Get Last Executed TalkBack Command

Obtenir la dernière commande Talkback exécutée à partir de la file d'attente Talkback

Requête

Méthode HTTP

GET

URL

https://api.thingspeak.com/talkbacks/<talkback_id>/commands/last.<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/last.json

Paramètres de la chaîne de 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

Type de contenu

application/x-www-form-urlencoded

Réponse

Succès

Code HTTP status

200 OK

Body

Laissez <format> vide pour recevoir la réponse au format texte.

GET https://api.thingspeak.com/talkbacks/12345/commands/last?api_key==XXXXXXXXXXXXXXXX

Exemple de réponse

OPENDOOR
GET https://api.thingspeak.com/talkbacks/12345/commands/last.json?api_key=XXXXXXXXXXXXXXXX

Réponse

{
  "command_string": "OPENDOOR",
  "created_at": "2018-12-29T17:53:40-05:00",
  "executed_at": "2018-12-30T17:53:40-05:00",
  "id": 2446323,
  "position": null
}
GET https://api.thingspeak.com/talkbacks/12345/commands/last.xml?api_key=XXXXXXXXXXXXXXXX

Réponse

<?xml version="1.0" encoding="UTF-8"?>
<command>
  <id type="integer">2446323</id>
  <command-string>OPENDOOR</command-string>
  <position type="integer" nil="true"/>
  <created-at type="datetime">2013-12-30T16:51:17-05:00</created-at>
  <executed-at type="datetime">2013-12-31T16:51:17-05:00</executed-at>
</command>

Erreur

S'il n'y a aucune commande exécutée pour cette instance de TalkBack, la requête renverra le code d'état HTTP 404 et error_resource_not_found.

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