Saltar al contenido principal
Las claves de API te permiten acceder a la API REST de Quikly de forma programática. Úsalas con n8n, scripts personalizados, pipelines CI/CD o cualquier cliente HTTP.

​
Crear una clave de API

1

Abre la configuración de claves de API

Ve a Configuración → Claves de API en la app de Quikly.
2

Haz clic en Crear Clave de API

Ingresa un nombre descriptivo (ej., “automatización n8n” o “Cursor MCP”) y selecciona los scopes que necesitas.
3

Copia la clave

La clave completa se muestra solo una vez. Cópiala y guárdala en un lugar seguro — no podrás recuperarla después.

​
Scopes

Cada clave de API tiene uno o más scopes que controlan lo que puede hacer:
ScopeNivel de accesoOperaciones de ejemplo
readSolo lecturaListar propuestas, obtener detalles de propuesta, recomendaciones de tarifas con IA
writeAcceso de escrituraCrear propuestas, compartir propuestas, enviar mensajes
read,writeAcceso completoTodas las operaciones (predeterminado)
Sigue el principio de mínimo privilegio. Si una integración solo necesita leer datos, crea una clave con scope read solamente.

​
Autenticar solicitudes

Incluye tu clave de API en el header X-API-Key en cada solicitud: 
curl -X GET "https://api.getquikly.com/api/external/v1/me" \
  -H "X-API-Key: qk_your_api_key_here"

​
Límites de tasa

Las llamadas a la API tienen límites de tasa por minuto y un tope mensual dependiendo de tu plan:
PlanCuota mensualLímite por minuto
Starter15 llamadas5/min
Professional2,000 llamadas30/min
Agency10,000 llamadas60/min
LifetimeIlimitadas60/min
Cuando excedes un límite, la API devuelve 429 Too Many Requests. La respuesta incluye un header Retry-After indicando cuándo puedes reintentar. Consulta tu uso actual con: 
curl -H "X-API-Key: qk_your_api_key_here" \
  "https://api.getquikly.com/api/external/v1/usage"
También puedes pre-verificar antes de una operación: 
curl -H "X-API-Key: qk_your_api_key_here" \
  "https://api.getquikly.com/api/external/v1/usage/precheck?operation=proposal_create"

​
Gestionar claves existentes

En Configuración → Claves de API, puedes:
  • Renombrar una clave para mantener tu lista organizada
  • Desactivar una clave temporalmente sin eliminarla
  • Revocar una clave permanentemente — las claves revocadas no se pueden reactivar

​
Mejores prácticas de seguridad

Nunca subas claves de API al control de versiones ni las expongas en código del lado del cliente.
  • Usa variables de entorno para almacenar claves en tu entorno de despliegue.
  • Rota claves periódicamente — crea una nueva clave, actualiza tus integraciones, luego revoca la anterior.
  • Usa el scope más restrictivo que tu integración requiera.
  • Establece expiración al crear claves para integraciones temporales. Puedes especificar expires_in_days durante la creación.
  • Monitorea el uso consultando el endpoint de usage o la página de Claves de API en el dashboard. Cada clave muestra su marca de tiempo del último uso.
  • Revoca inmediatamente si una clave se ve comprometida.

​
Formato de clave

Las claves de API de Quikly siguen el formato qk_ seguido de una cadena aleatoria. Cuando ves claves en el dashboard, solo el prefijo es visible (ej., qk_abc1...) — la clave completa solo se muestra al momento de crearla.