Contenuto principale

Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l'ultima versione in inglese.

Delete TalkBack Command

Elimina il comando TalkBack dalla coda TalkBack

Richiesta

Metodo HTTP

DELETE

URL

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

Argomenti di input

NomeDescrizione

<talkback_id>

(Obbligatorio) ID TalkBack, specificato come numero intero positivo.

<command_id>

(Obbligatorio) ID comando per il comando di interesse, specificato come numero intero positivo.

<format>

Formato per la risposta HTTP, specificato come json o xml.

Esempio: https://api.thingspeak.com/talkbacks/12345/commands/112233.json

Parametri della stringa di query

NomeDescrizioneTipo di valore
api_key

(Obbligatorio) Chiave API per questa specifica istanza di TalkBack. La chiave TalkBack è diversa dalle chiavi API del canale e dell'utente.

stringa

Tipo di contenuto

application/x-www-form-urlencoded

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

Lasciare <format> vuoto per ricevere la risposta in formato testo.

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

Esempio di risposta

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

Risposta

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

Risposta

<?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>

Errore

Per l'elenco completo, vedere Codici di errore.