Ir al contenido principal
miji.be

API key

Cadena de texto que autentica y controla el acceso a una API. Se utiliza para identificar al usuario y limitar el uso.

9 oct 2026 / Lectura de aproximadamente 1 min

Seguridad

Una API key es una cadena de caracteres única que se emite para identificar a quien accede a una Web API. Funciona de forma similar a un número de reserva en un restaurante: permite al servidor verificar que la persona tiene permiso para utilizar el servicio.

Las API keys cumplen tres funciones principales. Primera, autenticación (identificar quién realiza la solicitud). Segunda, control de acceso (limitar el volumen de uso o las funciones disponibles según el plan contratado). Tercera, seguimiento del uso (registrar quién llamó a la API, cuándo y cuántas veces).

La mayoría de los servicios de URL cortas ofrecen una API que permite acortar URL o consultar estadísticas de clics de forma programática. Para usar la API, es necesario registrarse, obtener una API key e incluirla en las cabeceras o parámetros de cada solicitud, por ejemplo: "Authorization: Bearer sk-abc123...".

El aspecto más crítico de la gestión de API keys es no exponerlas públicamente. Subir una clave por error a un repositorio de GitHub es un incidente frecuente. Según el informe de GitGuardian de 2023, en 2022 se filtraron 10 millones de secretos (API keys, contraseñas, etc.) en repositorios públicos de GitHub. La regla de oro es almacenar las claves en variables de entorno o en un servicio de gestión de secretos, y nunca escribirlas directamente en el código fuente.

También conviene distinguir entre API key y token OAuth. La API key es adecuada para la autenticación a nivel de aplicación y su configuración es sencilla. OAuth, en cambio, se usa para la autorización a nivel de usuario y permite un control de acceso más granular, aunque su implementación es más compleja. En proyectos personales o comunicación entre servidores puede bastar con una API key; cuando se necesita acceder a datos de usuario, OAuth es la opción indicada.

¿Te resultó útil este artículo?

Términos relacionados

Límite de tasa de API

Una restricción sobre el número de solicitudes de API que un cliente puede realizar dentro de un período de tiempo especificado.

HTTPS

La versión segura de HTTP que cifra los datos transmitidos entre un navegador y un servidor web utilizando TLS.

Validación de entrada

Proceso que verifica si los datos introducidos por los usuarios se ajustan al formato y al rango esperados. Es una de las medidas de seguridad.

CORS

Cross-Origin Resource Sharing - un mecanismo de seguridad del navegador que controla qué dominios pueden acceder a recursos de otro dominio.

SSL/TLS

Protocolos criptográficos que proporcionan comunicación segura a través de internet cifrando los datos entre cliente y servidor.

Gobernanza de enlaces

Marco operativo para gestionar centralizadamente los permisos de creación, convenciones de nomenclatura, políticas de expiración y controles de acceso de URLs acortadas.

Artículos relacionados

Guía de API de acortadores de URL - Generación programática de URLs cortas

Una guía práctica para usar APIs de acortadores de URL. Aprende sobre formatos de solicitud, estructuras de respuesta, autenticación y patrones de implementación.

Cómo acortar las largas URL de GitHub para optimizar tu flujo de trabajo de desarrollo

Gestiona con URL acortadas las largas URL de Issues, PRs y archivos en GitHub. Uso en READMEs, notificaciones CI/CD y alternativas tras el cierre de git.io.

Guía de seguridad de URLs cortas - Mejores prácticas para compartir enlaces seguros

Una guía completa de mejores prácticas de seguridad para URLs cortas. Comprende los riesgos y aprende a compartir enlaces de forma segura y responsable.

Preguntas frecuentes

¿Qué debo hacer si mi API key se filtra?
Revoca la clave de inmediato desde el panel de administración del servicio y genera una nueva. Revisa los registros de uso para comprobar si se ha producido algún acceso no autorizado. Si la clave se subió a GitHub, elimínala también del historial de commits.
¿Dónde debo almacenar una API key?
En variables de entorno (archivo .env) o en un servicio de gestión de secretos en la nube (como AWS Secrets Manager). Nunca la escribas directamente en el código fuente ni la incrustes en JavaScript del lado del cliente.
¿Las API keys tienen fecha de caducidad?
Depende del servicio. Algunas claves caducan automáticamente y otras permanecen activas hasta que se revocan manualmente. Desde el punto de vista de la seguridad, se recomienda rotar las claves periódicamente.

Pon los términos en práctica

Acorta una URL gratis