Autenticazione

Tutte le richieste API richiedono un Bearer token (chiave API) per l’autenticazione.

Creare una Chiave API

Accedi a IronFlock su app.ironflock.com.
Vai su Impostazioni Utente.
Naviga alla sezione Chiavi API.
Clicca su Crea Chiave API.
Copia la chiave generata — viene mostrata solo una volta.

Usare la Chiave API

Includi la chiave nell’header Authorization di ogni richiesta:


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

Esempio 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()

Esempio 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();

Risposte di Errore

Codice di Stato	Significato
`401`	Chiave API mancante o non valida
`403`	Privilegi insufficienti per questa operazione
`404`	Risorsa non trovata
`422`	Errore di validazione (controlla i parametri della richiesta)
`500`	Errore interno del server

Tutte le risposte di errore restituiscono un oggetto JSON:


{
    "error": "Description of the error"
}