Tutorial Interactivo
Próximamente: Vídeo interactivo con Clueso estará disponible aquí. Por ahora, sigue la guía paso a paso a continuación.
Visión General
Las API Keys de gu1 te permiten integrar la plataforma con tus propios sistemas, automatizar workflows y acceder a datos programáticamente.¿Qué son las API Keys?
Una API Key es una credencial de autenticación que identifica tu aplicación al hacer peticiones a la API de gu1. Es como una contraseña, pero diseñada para ser usada por aplicaciones en lugar de usuarios humanos.Tipos de API Keys
Production Key
Para datos reales
- Accede a datos de producción
- Modifica entidades reales
- Cobra por uso de integraciones
- Envía webhooks a endpoints reales
- Requiere máxima seguridad
Sandbox Key
Para desarrollo y pruebas
- Accede a datos de sandbox
- Ambiente aislado
- Sin costo adicional
- Ideal para desarrollo
- Puede compartirse en equipos de dev
Crear una Nueva API Key
1
Accede a Configuración
Navega a Settings > API Keys en el menú lateral izquierdo.
2
Haz Clic en 'Create API Key'
En la esquina superior derecha, haz clic en el botón + Create API Key (azul).
3
Configura la API Key
Completa la información:Nombre de la Key:
- Usa un nombre descriptivo (ej: “Integration Zapier”, “Mobile App”, “Data Pipeline”)
- Esto ayuda a identificar el uso más adelante
- Production: Para aplicaciones en producción
- Sandbox: Para desarrollo y pruebas
- Read: Solo lectura de datos
- Write: Crear y modificar entidades
- Delete: Eliminar entidades
- Execute: Ejecutar reglas e integraciones
4
Copia la API Key
La key tendrá este formato:Prefijos:
gk_production_...- Production keygk_sandbox_...- Sandbox key
5
Almacena de Forma Segura
Opciones recomendadas:
- Gestor de contraseñas: 1Password, LastPass, Bitwarden
- Variables de entorno:
.env(¡no commit en Git!) - Secret managers: AWS Secrets Manager, Google Secret Manager, HashiCorp Vault
- CI/CD secrets: GitHub Secrets, GitLab CI Variables
- Commitear en el código
- Compartir por email/Slack
- Incluir en screenshots
- Dejar en archivos de log
Usar tu API Key
Autenticación HTTP
Todas las peticiones deben incluir la API key en el headerAuthorization:
Ejemplos de Código
- JavaScript/Node.js
- Python
- PHP
- Ruby
Gestionar API Keys Existentes
Ver Todas las Keys
En la página Settings > API Keys, verás una lista de todas las keys activas con información clave como nombre, ambiente, último uso, creación y permisos.Nota de Seguridad: Solo los primeros y últimos 4 caracteres de la key se muestran (ej:
gk_p...3d5). La key completa no puede recuperarse.Revocar una API Key
Si una key fue comprometida o ya no es necesaria, puedes revocarla inmediatamente. Esta acción es irreversible y todas las integraciones usando esta key dejarán de funcionar.Rotar una API Key
La rotación es la práctica de sustituir una key periódicamente por seguridad. Se recomienda rotar API keys de producción cada 90 días.Seguridad y Buenas Prácticas
Almacenamiento Seguro
Usa variables de entorno, secret managers y nunca commites keys en Git
Rotación Regular
Production: cada 90 días, inmediatamente si comprometida
Menor Privilegio
Usa permisos mínimos necesarios para cada integración
Monitoreo
Revisa uso regularmente y configura alertas de anomalías
Rate Limits y Quotas
| Plano | Requisiciones/min | Requisiciones/día | Burst |
|---|---|---|---|
| Starter | 60 | 10.000 | 10 |
| Professional | 300 | 100.000 | 50 |
| Enterprise | 1.000 | Ilimitado | 200 |
X-RateLimit-*.
Próximos Pasos
API Reference
Documentación completa de la API REST
SDK de gu1
Bibliotecas JavaScript, Python, Ruby, PHP
Webhooks
Configura notificaciones en tiempo real
Ejemplos de Código
Integraciones listas (Zapier, n8n, Make)
¿Necesitas Ayuda?
- Documentación: Navega por nuestras guías completas
- Email: [email protected]
- Dashboard: Accede a tu cuenta en app.gu1.ai
Última actualización: Enero 2025