Authentification

Toutes les requêtes API nécessitent un token Bearer (clé API) pour l’authentification.

Créer une clé API

Connectez-vous à IronFlock sur app.ironflock.com.
Allez dans Paramètres utilisateur.
Naviguez vers la section Clés API.
Cliquez sur Créer une clé API.
Copiez la clé générée — elle n’est affichée qu’une seule fois.

Utiliser la clé API

Incluez la clé dans l’en-tête Authorization de chaque requête :


curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.ironflock.com/v1/ironflock/devices

Exemple Python


import requests
 
API_KEY = "your-api-key"
BASE_URL = "https://api.ironflock.com/v1/ironflock"
 
headers = {"Authorization": f"Bearer {API_KEY}"}
 
response = requests.get(f"{BASE_URL}/devices", headers=headers)
devices = response.json()

Exemple JavaScript


const API_KEY = "your-api-key";
const BASE_URL = "https://api.ironflock.com/v1/ironflock";
 
const response = await fetch(`${BASE_URL}/devices`, {
    headers: { Authorization: `Bearer ${API_KEY}` }
});
const devices = await response.json();

Réponses d’erreur

Code de statut	Signification
`401`	Clé API manquante ou invalide
`403`	Privilèges insuffisants pour cette opération
`404`	Ressource introuvable
`422`	Erreur de validation
`500`	Erreur interne du serveur