Cómo crear y usar una clave de API en SolumeCore

Para crear una clave de API de SolumeCore, abre API y webhooks en el menú del panel, haz clic en Nueva clave, ponle un nombre y confirma que eres tú. Copia el secreto que aparece, porque se muestra una sola vez. Después pídenos por ticket que autoricemos las direcciones IP desde las que llamará tu programa: la clave no responde hasta que eso esté hecho.

Qué puede hacer una clave de API

Una clave de API es como una contraseña para tus programas. Actúa solo sobre tus propios servicios, nunca sobre los de nadie más, y a través de la API pública puede hacer lo siguiente:

• Listar tus servicios y consultar los detalles de uno: id, nombre de host, estado, plan e IP.
• Encender, apagar o reiniciar un servicio que tenga una instancia de servidor, como una VPS o una VDS.
• Consultar y modificar la configuración del firewall de un servicio.

Las claves no tienen niveles de permisos separados: una clave válida puede hacer todo lo anterior en todos los servicios de tu cuenta. Por eso conviene crear una clave por cada programa, para poder revocar cada una por separado.

Crea una clave

1. Entra en dashboard.solumecore.com.
2. En el menú, dentro de Cuenta, abre API y webhooks. Llegas a la pestaña Claves de API.
3. Haz clic en Nueva clave (o en Crear tu primera clave).
4. Escribe un Nombre que te diga qué la usa, como «Panel de reventa». Hasta 60 caracteres.
5. Haz clic en Crear clave.
6. El panel te pide confirmar que eres tú con tu contraseña, un código 2FA, tu passkey o un código por correo. Es obligatorio porque una clave dura más que tu sesión.
7. Una ventana muestra la Clave secreta, que empieza por sk_live_. Cópiala en tu gestor de contraseñas o de secretos.
8. Marca Ya la guardé. Si la pierdes no podemos mostrártela otra vez: crea otra.

La lista muestra después tu clave con su nombre y sus primeros caracteres, junto con sus IPs autorizadas, el último uso, la fecha de creación y el estado.

Consigue que autoricen tu IP

Por seguridad, una clave solo funciona desde las direcciones IP que nuestro equipo autoriza para ella. No puedes añadirlas tú.

1. Tras guardar la clave, haz clic en Pedir que autoricen IPs. Se abre un ticket con el asunto y el mensaje ya escritos.
2. Sustituye el texto de ejemplo por las direcciones IP públicas desde las que llamará tu programa, una por línea.
3. Envía el ticket. Las autorizamos a mano, normalmente en pocas horas.
4. Cuando las aprobamos, la columna IPs autorizadas las muestra en lugar de Esperando IPs.

Averigua la IP pública de la máquina que hará las llamadas. Funciona mejor una dirección fija, como la de un servidor, porque las conexiones domésticas suelen cambiar de IP y la clave dejaría de funcionar hasta que autoricemos la nueva.

Haz tu primera llamada

Envía la clave en la cabecera Authorization. La pestaña Primeros pasos de la misma página tiene la dirección de la API y ejemplos listos para copiar. Sustituye TU_API_KEY por tu clave.

curl https://api.solumecore.com/v1/services \
  -H "Authorization: Bearer TU_API_KEY"

const r = await fetch('https://api.solumecore.com/v1/services', {
  headers: { Authorization: `Bearer ${process.env.SOLUME_API_KEY}` },
});
console.log(await r.json());

import os, requests

r = requests.get(
    "https://api.solumecore.com/v1/services",
    headers={"Authorization": f"Bearer {os.environ['SOLUME_API_KEY']}"},
)
print(r.json())

La respuesta es una lista de tus servicios:

[
  {
    "id": "vps-3315",
    "hostname": "web-prod",
    "estado": "ACTIVO",
    "plan": "VPS 4 GB",
    "ip": "203.0.113.42"
  }
]

Para reiniciar un servicio, llama al endpoint de energía con el id de esa lista. Usa start, stop o restart. Responde 204 cuando termina.

curl -X POST https://api.solumecore.com/v1/services/vps-3315/power/restart \
  -H "Authorization: Bearer TU_API_KEY"

Los endpoints son GET /v1/services, GET /v1/services/:id, POST /v1/services/:id/power/:accion y las rutas de firewall bajo /v1/services/:id/firewall.

Límites

Las solicitudes se limitan por clave y por IP. Por defecto puedes hacer 300 solicitudes generales por minuto, 20 acciones de energía por minuto y 60 solicitudes de firewall por minuto. Si te pasas, la API responde 429 y la cabecera retry-after indica cuántos segundos esperar. Las cabeceras x-ratelimit-limit y x-ratelimit-remaining muestran tu cupo.

Revoca o borra una clave

1. En la pestaña Claves de API, abre el menú de opciones (tres puntos) de la clave.
2. Elige Revocar y confirma. Deja de funcionar al instante y los programas que la usen recibirán errores.
3. Una clave revocada se puede quitar de la lista con Borrar, escribiendo su nombre para confirmar. No se puede deshacer.

Restablecer tu contraseña mediante el enlace del correo también revoca todas tus claves de API. Mira cómo recuperar una contraseña olvidada.

Solución de problemas

401: clave inválida o revocada

Falta la cabecera Authorization: Bearer ..., la clave se copió incompleta o fue revocada. Crea una clave nueva si perdiste el secreto.

403: esta IP no está autorizada

La llamada vino de una dirección que no está en la lista de la clave. Comprueba la IP pública de la máquina o pídenos que la añadamos. También aparece un 403 si la cuenta está suspendida o la IP está bloqueada.

409: el servicio todavía no está activo

Las acciones de energía solo funcionan cuando el servicio está activo y listo. Revisa su estado en el panel.

429: demasiadas solicitudes

Reduce el ritmo y reintenta pasados los segundos de retry-after. Guarda en caché la lista de servicios en lugar de pedirla en cada llamada.

Preguntas frecuentes

¿La API tiene costo?

Crear claves no cuesta nada. Todo lo que hagas con la API sigue las mismas reglas y la misma facturación que en el panel.

¿Puedo ver otra vez mi clave secreta?

No. Solo guardamos una huella protegida de ella, así que el secreto se muestra una vez al crearla. Crea una clave nueva si la pierdes.

¿Puedo limitar lo que hace una clave?

No hay permisos por clave. Lo más seguro es una clave por programa, autorizada solo desde las IPs necesarias, y revocada en cuanto dejes de usarla.

¿Y si mi clave se filtró?

Revócala de inmediato desde el menú de la clave, crea una nueva y actualiza tus programas. Después revisa la actividad de tu cuenta.

Artículos relacionados

• Cómo gestionar sesiones y dispositivos
• Cómo activar la verificación en dos pasos
• Cómo abrir un ticket de soporte
• Cómo conectarte a tu VPS por SSH

¿Estás construyendo algo que necesita servidores fiables? Echa un vistazo a nuestros planes de VPS.