Actualizado el 31 oct 2026
Crear una clave API
Una clave API permite que un programa gestione por ti una de tus direcciones IP: leer su configuración, actualizar sus redirecciones de puertos y descargar su configuración de WireGuard, todo ello sin que nadie inicie sesión en el panel. El agente Docker usa una para mantener tus redirecciones de puertos al día con tus contenedores cada vez que se reinician.
Las claves pertenecen a una sola dirección IP, no a tu cuenta. Si tienes varias direcciones IP, cada una tiene su propia clave, y una clave nunca da acceso a ninguna de las demás.
Abre tu dirección IP
Ve a Tus IPs en el panel y haz clic en el icono del lápiz al final de la fila de la dirección IP para la que quieres una clave.
Busca el apartado Acceso a la API
Despliega la sección Configuración. Acceso a la API está a la derecha, junto a las descargas de la configuración de WireGuard. Haz clic en Gestionar clave API.
Puedes hacerlo en cualquier momento. No hace falta que la dirección IP termine de aprovisionarse antes de crear su clave.
Crea la clave
Si esta dirección IP todavía no tiene clave, el diálogo muestra No se encontró ninguna clave API. Haz clic en Crear.
Copia la clave
La clave aparece al instante, junto con la fecha y la hora en que se creó. Usa el icono de copiar, a la derecha del campo, para copiarla al portapapeles.
Trata esta clave como una contraseña. Cualquiera que la tenga puede cambiar cómo tu dirección IP redirige el tráfico y descargar su configuración de WireGuard.
Eso sí, no hace falta que la guardes ahora mismo. A diferencia de la mayoría de los servicios, GetPublicIP no oculta la clave después de que la veas por primera vez. Vuelve a abrir Gestionar clave API siempre que la necesites.
Último uso muestra Nunca hasta que algo se autentica con la clave, y a partir de ahí se actualiza con cada petición. Es la forma más rápida de confirmar que una herramienta que has configurado está llegando de verdad hasta nosotros.
Sustituir y revocar una clave
Las dos acciones están en el mismo diálogo Gestionar clave API.
- Crear sustituye la clave existente por una nueva. No hay ningún paso de
confirmación, y la clave anterior deja de funcionar en cuanto aparece la nueva, así
que todo lo que aún la use, como un agente Docker en ejecución, empezará a fallar
con
401hasta que le des la clave nueva. No pulses Crear solo para comprobar cuál es tu clave: al volver a abrir el diálogo ya la ves. - Eliminar revoca la clave y deja la dirección IP sin ninguna. Tu túnel, tus redirecciones de puertos y la propia dirección IP no se tocan; solo se retira el acceso programático. Crea una clave nueva cuando quieras recuperarlo.
Preguntas frecuentes
¿Una clave API está vinculada a mi cuenta o a una sola dirección IP?
A una sola dirección IP. Cada dirección IP de tu panel tiene su propia clave, y una clave solo da acceso a la dirección a la que pertenece. Si usas varias direcciones IP, crea una clave distinta para cada una.
¿Puedo volver a ver mi clave API después de crearla?
Sí. La clave no se muestra una sola vez. Vuelve a abrir Gestionar clave API en esa dirección IP cuando quieras y seguirá ahí para copiarla, así que no hace falta que la guardes en ningún sitio antes de cerrar el diálogo.
¿Qué pasa si pulso Crear cuando ya tengo una clave?
Obtienes una clave totalmente nueva y la anterior deja de funcionar de inmediato. No hay ningún paso de confirmación, así que no pulses Crear para comprobar cuál es tu clave. Todo lo que siga usando la clave anterior, como un agente Docker en ejecución, empezará a recibir errores 401 hasta que le des la nueva.
¿Cómo revoco una clave API?
Abre Gestionar clave API en esa dirección IP y pulsa Eliminar. La clave deja de funcionar al instante. Tu dirección IP, su túnel y sus redirecciones de puertos no se ven afectados; solo se retira el acceso programático.
¿Necesito una clave API para usar mi dirección IP pública?
No. Puedes descargar tu configuración de WireGuard y editar las redirecciones de puertos desde el panel sin ella. Solo necesitas una clave cuando quieres que una herramienta lo haga por ti, como el agente Docker de GetPublicIP o la app GetPublicIP for Windows (beta, recomendada).
La guía de Docker explica cómo usar tu clave para exponer tus contenedores a través de tu dirección IP pública. Si es tu primera vez con GetPublicIP, empieza por Primeros pasos.