Crear y gestionar con seguridad claves de API: leer, escribir, revocar

Qué es una clave de API

Una clave de API es una cadena de caracteres larga y aleatoria con la que un programa se identifica ante un servicio. Quien la conoce puede hacer todo lo que la clave permite. Por eso una clave de API debe guardarse con tanta seguridad como una contraseña. En Same-QR la necesitas para la línea de comandos sameqr, para tus propios scripts con la API REST y para agentes de programación como Claude Code, Cursor y Codex. ChatGPT y Claude.ai no necesitan ninguna, inician sesión mediante OAuth.

Paso 1: encontrar el lugar adecuado

Inicia sesión en el panel y abre Cuenta. Ahí está la sección “Acceso para CLI, scripts y agentes”. Las claves solo se pueden crear aquí, iniciando sesión en el navegador. Una clave no puede generar más claves, así que una clave robada no se multiplica.

Paso 2: elegir los permisos

Hay tres niveles. Elige siempre el más pequeño que baste para la tarea.

• Informes de escaneos, análisis, un asistente que solo responde preguntas: solo lectura.
• Scripts que crean códigos QR y páginas, cambian nombres y textos, publican o importan tarjetas: lectura + escritura.
• Procesos que cambian los destinos de códigos QR existentes, ponen páginas offline o las eliminan: completa. Cada cambio de este tipo requiere una confirmación con el estado leído, y por la API se permiten como máximo 10 por hora y 30 por día.

Con una clave de lectura se rechaza cualquier solicitud que modifique datos. Un agente de programación conectado por MCP con una clave de lectura ni siquiera ve las herramientas de escritura.

Paso 3: vigencia y nombre

Toda clave caduca: a los 30, 90, 180 o 365 días, y por defecto son 90. También se puede elegir sin límite, pero tienes que hacerlo de forma consciente, por ejemplo para una tarea nocturna sin personas que la renueve. Ponle a la clave un nombre según su finalidad, por ejemplo “Informe mensual cliente A”. Puedes tener hasta 10 claves por cuenta.

Paso 4: guardarla de inmediato con seguridad

La clave empieza por sqr_live_ y se muestra exactamente una vez. Same-QR solo guarda una suma de comprobación y no puede volver a mostrártela más tarde. Guárdala directamente en tu gestor de contraseñas. Los programas la leen al arrancar desde la variable de entorno SAMEQR_API_KEY. Una clave no debe estar:

• en el código fuente, y menos aún en un repositorio público,
• en una dirección, porque las direcciones acaban en registros e historiales,
• en una hoja de cálculo, un correo o un mensaje de chat,
• en el chat con un asistente de IA,
• como argumento de un comando, porque entonces queda en el historial de la shell.

El inicio fijo sqr_live_ tiene un propósito: las herramientas que buscan secretos publicados por error reconocen la clave por él.

Paso 5: revocar cuando haga falta

En la misma lista revocas una clave con un clic. Deja de ser válida al instante y tus códigos QR siguen sin cambios. Las claves caducadas permanecen en la lista con una nota, para que veas por qué un script de repente ya no pasa. Además, un cambio de contraseña revoca todas las claves a la vez. Revoca una clave si ha quedado visible en algún sitio, si un proveedor ya no trabaja para ti o si ya no recuerdas para qué sirve.

Conclusión: por qué Same-QR

Same-QR se toma en serio las claves: permisos separados, vigencias con un valor por defecto razonable, visualización una sola vez, almacenamiento solo como suma de comprobación y revocación con efecto inmediato. Así puedes usar la API, la CLI y los agentes de programación con tranquilidad, en todas las tarifas.

Empieza ya: regístrate gratis en sameqr.com, 20 códigos QR dinámicos son gratuitos para siempre. La API, la CLI y el servidor MCP están disponibles en todas las tarifas, y la documentación está en sameqr.com/entwickler.

Preguntas frecuentes