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

Delete Channel

Supprimer le canal avec HTTP DELETE

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

Requête

Méthode HTTP

DELETE

URL

https://api.thingspeak.com/channels/<channel_id>.<format>

Paramètres d'URL

NomDescription

<channel_id>

(Obligatoire) ID du canal pour le canal d’intérêt, spécifié sous la forme d'un nombre entier.

<format>

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

Exemple : https://api.thingspeak.com/channels/999990.json

Paramètres du corps de la requête

NomDescriptionType de valeur
api_key

(Obligatoire) Spécifiez la clé API utilisateur, que vous pouvez trouver dans votre profil. Cette clé est différente des clés d'API de canal.

chaîne de caractère

Type de contenu

application/x-www-form-urlencoded

Réponse

Succès

Code HTTP status

200 OK

Body
DELETE https://api.thingspeak.com/channels/4.json
       api_key=XXXXXXXXXXXXXXXX

La réponse est un objet JSON du canal avant sa suppression, par exemple :

{
  "id": 4,
  "name": "My New Channel",
  "description": null,
  "latitude": null,
  "longitude": null,
  "created_at": "2014-03-25T13:12:50-04:00",
  "elevation": null,
  "last_entry_id": null,
  "ranking": 15,
  "username": "iothans",
  "tags": []
}
DELETE https://api.thingspeak.com/channels/4.xml
       api_key=XXXXXXXXXXXXXXXX

La réponse est un objet XML du canal avant sa suppression, par exemple : 

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">4</id>
    <name>My New Channel</name>
    <description nil="true" />
    <latitude type="decimal" nil="true" />
    <longitude type="decimal" nil="true" />
    <created-at type="dateTime">2014-03-25T20:17:44-04:00</created-at>
    <elevation nil="true" />
    <last-entry-id type="integer" nil="true" />
    <ranking type="integer">15</ranking>
    <username>iothans</username>
    <tags type="array" />
</channel>

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 effacer un canal à l'aide de POSTMAN.

Voici le format de la requête HTTP.

DELETE https://api.thingspeak.com/channels/400834.json
       api_key=XXXXXXXXXXXXXXXX

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

  2. Dans la barre d'adresse, saisissez https://api.thingspeak.com/channels/<channelID>.json, en remplaçant <channelID> par l'ID du canal que vous souhaitez supprimer.

  3. Sous la section Body, choisissez x-www-form-urlencoded.

  4. Saisissez le paramètre api_key et votre clé API utilisateur, qui se trouve dans Account > My Profile.

La réponse est un objet JSON des paramètres du canal avant la suppression.

Voir aussi

Fonctions

Rubriques