API Adafruit IO HTTP

Description de l'API Adafruit IO

Adafruit IO fournit une API HTTP permettant d’accéder à vos données depuis n’importe quel environnement capable de parler HTTP. La documentation officielle indique que l’API sert à consulter, publier et gérer les données Adafruit IO, notamment les feeds, dashboards et autres ressources de l’écosystème.

Qu'est-ce que l'API Adafruit IO ?

L'API Adafruit IO est une interface pensée pour l’Internet des objets, avec une logique simple : envoyer des données vers des feeds et les exploiter dans des tableaux de bord ou dans des applications. Elle s’adresse autant aux développeurs qu’aux utilisateurs de microcontrôleurs et s’accompagne de bibliothèques clientes pour Python, Ruby, Arduino, JavaScript et Go. [web:25]

Caractéristiques de l'API Adafruit IO

• Accès HTTP universel : l’API peut être utilisée depuis presque n’importe quel langage ou matériel capable d’émettre des requêtes HTTP.
• Authentification simple : chaque requête peut être authentifiée avec l’en-tête X-AIO-Key ou, selon la documentation, via un paramètre de requête.
• Gestion des feeds : l’API permet de lister et manipuler les feeds d’un utilisateur, avec récupération des métadonnées et de la dernière valeur.
• Compatibilité IoT : elle est adaptée aux cartes et environnements embarqués comme l’ESP8266, grâce à des exemples utilisant HTTPClient en HTTPS.
• Bibliothèques clientes : Adafruit propose des clients open source pour accélérer l’intégration dans différents langages.
• Documentation exploitable : la documentation officielle est structurée autour de l’API HTTP et d’exemples concrets pour démarrer rapidement. [web:20]

Comment intégrer l'API Adafruit IO : Exemple d'implémentation

Voici des exemples simples pour récupérer la liste des feeds d’un utilisateur. L’authentification se fait avec votre clé Adafruit IO dans l’en-tête X-AIO-Key, comme indiqué dans la documentation officielle.

const axios = require('axios');

const AIO_USERNAME = 'YOUR_USERNAME';
const AIO_KEY = 'YOUR_AIO_KEY';
const API_URL = `https://io.adafruit.com/api/v2/${AIO_USERNAME}/feeds`;

async function getFeeds() {
  try {
    const response = await axios.get(API_URL, {
      headers: {
        'X-AIO-Key': AIO_KEY,
        'Content-Type': 'application/json'
      }
    });
    return response.data;
  } catch (error) {
    console.error('Erreur lors de la récupération des feeds Adafruit IO :', error.response?.data || error.message);
    throw error;
  }
}

// Exemple d'utilisation
// getFeeds().then(data => console.log(data));
                

import requests

AIO_USERNAME = 'YOUR_USERNAME'
AIO_KEY = 'YOUR_AIO_KEY'
API_URL = f'https://io.adafruit.com/api/v2/{AIO_USERNAME}/feeds'

def get_feeds():
    headers = {
        'X-AIO-Key': AIO_KEY,
        'Content-Type': 'application/json'
    }
    response = requests.get(API_URL, headers=headers)
    if response.status_code == 200:
        return response.json()
    raise Exception(f"Erreur lors de la récupération des feeds Adafruit IO: {response.status_code} - {response.text}")

# Exemple d'utilisation
# data = get_feeds()
# print(data)
                

-- php --
$aioUsername = 'YOUR_USERNAME';
$aioKey = 'YOUR_AIO_KEY';
$apiUrl = 'https://io.adafruit.com/api/v2/' . $aioUsername . '/feeds';

function getFeeds($apiUrl, $aioKey) {
    $ch = curl_init($apiUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'X-AIO-Key: ' . $aioKey,
        'Content-Type: application/json'
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode === 200) {
        return json_decode($response, true);
    }

    throw new Exception("Erreur lors de la récupération des feeds Adafruit IO: $httpCode - $response");
}

// Exemple d'utilisation
// $data = getFeeds($apiUrl, $aioKey);
// print_r($data);
?>
                

Idées d'utilisation de l'API Adafruit IO

• Tableaux de bord IoT : afficher en temps réel les valeurs de capteurs dans une interface web.
• Suivi environnemental : centraliser les données de température, d’humidité ou de pression provenant d’objets connectés.
• Automatisation de projets makers : piloter des actions à partir d’événements envoyés vers un feed.
• Prototypage rapide : tester une solution IoT avec une API simple avant de passer à une architecture plus complexe.
• Formation et pédagogie : apprendre les bases de l’IoT, de l’HTTP et des tableaux de bord avec une API accessible et bien documentée.