Autenticación

Todas las solicitudes a la API requieren un Bearer token (clave API) para la autenticación.

Crear una clave API

Inicia sesión en IronFlock en app.ironflock.com.
Ve a User Settings.
Navega a la sección API Keys.
Haz clic en Create API Key.
Copia la clave generada — solo se muestra una vez.

Uso de la clave API

Incluye la clave en el encabezado Authorization de cada solicitud:


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

Ejemplo en 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()

Ejemplo en 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();

Respuestas de error

Código de estado	Significado
`401`	Clave API faltante o inválida
`403`	Privilegios insuficientes para esta operación
`404`	Recurso no encontrado
`422`	Error de validación (verifica los parámetros de la solicitud)
`500`	Error interno del servidor

Todas las respuestas de error devuelven un objeto JSON:


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