Primeros pasos

La API pública de Lueira (v1) es REST sobre HTTPS, con peticiones y respuestas en JSON. Todos los endpoints cuelgan de una única URL base.

URL base

shell

https://api.lueira.com/api/v1

1. Crea una API Key

Desde el panel de Lueira, ve a Ajustes → Desarrolladores → API Keys y crea una nueva clave, eligiendo los scopes que necesites.

El secreto solo se muestra una vez, justo después de crearlo. Guárdalo en un gestor de secretos: si lo pierdes tendrás que rotar la clave.

2. Haz tu primera petición

Todas las peticiones autenticadas usan un header Authorization: Bearer. Para listar tus clientes:

curl

curl "https://api.lueira.com/api/v1/customers" \
  -H "Authorization: Bearer luk_tu_clave_aqui"

3. Ejemplo en Node.js

Node.js

const res = await fetch("https://api.lueira.com/api/v1/customers", {
  headers: { Authorization: `Bearer ${process.env.LUEIRA_API_KEY}` },
});
const { data } = await res.json();
console.log(data);

4. Ejemplo en Python

Python

import os, requests

res = requests.get(
    "https://api.lueira.com/api/v1/customers",
    headers={"Authorization": f"Bearer {os.environ['LUEIRA_API_KEY']}"},
)
print(res.json())

5. Siguientes pasos

Autenticación — formato de la clave y scopes disponibles.
Paginación — cómo recorrer listados grandes.
Errores — formato de las respuestas de error.
Límites — cuántas peticiones puedes hacer por minuto y por mes.
Webhooks — recibe notificaciones en tiempo real de eventos en tu cuenta.
Servidor MCP — conecta asistentes de IA a tu cuenta.