Autenticación
DatIA usa API Keys para autenticar requests externos.
Obtener una API Key
- Inicia sesión en dat-ia.app
- Ve a Configuración → API Keys
- Click en "Nueva API Key"
- Selecciona los scopes necesarios
- Guarda la key inmediatamente (no se mostrará de nuevo)
Usar la API Key
Incluye el header X-API-Key en todos tus requests:
curl https://dat-ia.app/api/v1/catalog/items \
-H "X-API-Key: datia_live_xxxxxxxxxxxx"
Scopes disponibles
| Scope | Descripción |
|---|---|
catalog:read | Leer productos y precios |
catalog:write | Crear/modificar productos |
products:read | Ver detalles de productos |
analytics:read | Acceder a métricas |
agent:read | Recibir respuestas del AI |
agent:write | Enviar mensajes al AI |
Errores comunes
| Código | Descripción |
|---|---|
| 401 | API Key inválida o ausente |
| 403 | Scope insuficiente |
| 429 | Rate limit excedido |