Claves de API
Las claves de API te permiten autenticar solicitudes programáticas a la API de Iara Data.
Crear una Clave de API
- Ve a Configuración → Administrar Claves de API
- Haz clic en Crear Clave
- Asígnale un nombre (por ejemplo, "Pipeline de Producción")
- Opcionalmente define alcances para restringir el acceso (por ejemplo,
ingest:write, kpi:read) - Haz clic en Crear
aviso
¡Copia tu clave de inmediato! La clave completa solo se muestra una vez. Después de cerrar el diálogo, solo verás una versión truncada.
Administrar Claves
| Columna | Descripción |
|---|---|
| Clave | Clave truncada con botón de copiar |
| Nombre | Etiqueta legible para humanos |
| Alcances | Lista de permisos separados por coma |
| Último Uso | Marca de tiempo relativa (por ejemplo, "hace 2 horas") |
| Creada | Fecha de creación de la clave |
Acciones
| Acción | Descripción |
|---|---|
| Copiar | Copiar la clave truncada al portapapeles |
| Rotar | Generar un nuevo valor de clave (la clave anterior deja de funcionar inmediatamente) |
| Eliminar | Eliminar la clave permanentemente |
Alcances Disponibles
| Alcance | Acceso |
|---|---|
ingest:write | Subir datos, crear/administrar pipelines |
ingest:read | Leer datasets e historial de ingestión |
curupira:query | Usar el chat de IA |
kpi:read | Leer valores de KPI y dashboards |
kpi:write | Crear/modificar KPIs y dashboards |
analyze:invoke | Ejecutar análisis e investigaciones |
billing:read | Ver información de facturación y consumo |
users:manage | Invitar/administrar miembros del equipo |
audit:read | Ver registros de auditoría |
keys:read | Listar claves de API |
keys:write | Crear/rotar/eliminar claves de API |
webhooks:read | Listar webhooks |
webhooks:write | Crear/modificar/eliminar webhooks |
Ejemplo de Uso
# Obtener tus datasets
curl https://lake.iaradata.com/api/v1/datasets \
-H "Authorization: Bearer sk_live_abc123..."
# Hacerle una pregunta a la IA
curl -X POST https://lake.iaradata.com/api/v1/curupira/ask \
-H "Authorization: Bearer sk_live_abc123..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"question": "What was total revenue last month?",
"mode": "agentic",
"execute": true
}'