Contenu principal

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

Delete TalkBack Command

Supprimer la commande Talkback de la file d'attente Talkback

Requête

Méthode HTTP

DELETE

URL

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

Arguments d'entrée

NomDescription

<talkback_id>

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

<command_id>

(Obligatoire) ID de commande pour la commande qui vous intéresse, 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/112233.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.

DELETE https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands/COMMAND_ID
       api_key=YOUR_TALKBACK_API_KEY=XXXXXXXXXXXXXXXX

Exemple de réponse

OPENDOOR
DELETE https://api.thingspeak.com/talkbacks/12345/commands/2448500.json
       api_key=XXXXXXXXXXXXXXXX

Réponse

{
  "command_string": "OPENDOOR",
  "created_at": "2018-12-29T17:53:40-05:00",
  "executed_at": null,
  "id": 2448500,
  "position": 5
}
DELETE https://api.thingspeak.com/talkbacks/TALKBACK_ID/commands/COMMAND_ID.xml
       api_key=XXXXXXXXXXXXXXXX

Réponse

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

Erreur

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