API de SolumeCore: REST, webhooks, MCP y bots

SolumeCore te ofrece varias formas de automatizar tus servicios y de enterarte de lo que ocurre, y cada una encaja con un trabajo distinto. La API REST con clave de API controla tus VPS y VDS desde código. Los webhooks y las integraciones envían eventos de SolumeCore a tus propios sistemas, a Discord, Slack, Telegram, Teams o al correo. La API de IA (MCP) permite que un asistente como Claude o ChatGPT gestione tus servidores bajo tus reglas. El bot de Discord deja que tu comunidad consulte el estado y despierte un servidor. Esta página es el mapa: qué hace cada superficie, cómo se autentica y dónde leer más.

Todas están disponibles en el panel de cliente (dashboard.solumecore.com), en el menú Cuenta, y todas están ligadas a tu propia cuenta: solo pueden ver y manejar los servicios que te pertenecen.

¿Cuál debo usar?

Cómo se comparan

Primeros pasos con la API REST

La dirección base es https://api.solumecore.com y todos los endpoints empiezan por /v1. Crea una clave, pide a soporte que autorice la IP pública desde la que corre tu código (mira claves de API) y luego:

export SOLUME_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Listar servicios
curl https://api.solumecore.com/v1/services \
  -H "Authorization: Bearer $SOLUME_API_KEY"

# Reiniciar uno (responde 204 sin cuerpo)
curl -X POST https://api.solumecore.com/v1/services/vps-1000/power/restart \
  -H "Authorization: Bearer $SOLUME_API_KEY"

Las respuestas son JSON con claves y valores en español. Un servicio tiene este aspecto:

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

estado es uno de APROVISIONANDO, ACTIVO, SUSPENDIDO, PAUSADO, CANCELADO o ERROR. GET /v1/services/:id añade fechaProximaRenovacion.

Detalles que conviene conocer de la API de cliente

La referencia de la API de cliente enumera los endpoints. Estos puntos sobre cómo se comporta hoy la API la completan:

• Rutas: con la dirección base de arriba, el endpoint de un servicio es https://api.solumecore.com/v1/services/vps-1000. No repitas /v1.
• Qué se lista: GET /v1/services devuelve todos los servicios de tu cuenta, sea cual sea su tipo. Las acciones de energía y de firewall están pensadas para servicios VPS y VDS; en otros tipos de servicio lo habitual es recibir un 409.
• Errores: JSON { "error": "..." }, con el mensaje en español por ahora. Guíate por el código de estado: 400 datos no válidos, 401 falta la clave o es incorrecta, 403 IP no autorizada, cuenta suspendida o cerrada, o IP bloqueada, 404 el servicio no existe o no es tuyo, 409 el servicio no está activo, está en mantenimiento, aún no tiene IP o está bloqueado por reglas de uso o de seguridad al encenderlo, 429 límite de peticiones (lee retry-after), 502 o 503 el nodo o el firewall no respondieron, así que reintenta más tarde.
• Energía: POST /v1/services/:id/power/start, stop o restart, con respuesta 204.
• Leer el firewall devuelve la dirección y estas listas:

{
  "ip": "203.0.113.42",
  "geoblock": ["CN"],
  "geoPolicy": "blacklist",
  "srcwl": ["198.51.100.0/24"],
  "asnBlock": ["4837"],
  "blacklist": [{ "ip": "192.0.2.9", "manual": true }]
}

• Cambiar el firewall con POST o DELETE en /v1/services/:id/firewall/:feature responde { "ok": true }. La petición DELETE lleva el mismo cuerpo JSON que el POST. Además de las reglas de la referencia existen dos más: geo-rate (country, proto como tcp o udp, y pps; se quita con country y proto) y fivem-cache (cuerpo vacío {}).
• Ajustes, no entradas: rdp-filter, ssh-filter, udp-strict, geoblock-policy y filter-mode se cambian enviando un valor nuevo con POST. Un DELETE sobre ellos devuelve 400.
• Los límites de peticiones se cuentan por clave, por IP de origen y por grupo (lectura, energía, firewall). Los valores por defecto son 300, 20 y 60 peticiones por minuto, y SolumeCore puede cambiarlos por clave.

Convenciones comunes a todas las superficies

• Todo va por HTTPS. Los secretos (claves de API, secretos de webhook whsec_, tokens slm_ai_, URL de destinos) se muestran una sola vez o se guardan cifrados, y puedes revocarlos o rotarlos.
• Crear una credencial de larga duración te pide confirmar que eres tú y no se puede hacer desde una sesión de soporte. Recibes un aviso cuando se crea una.
• Los nombres de eventos y de campos de los payloads de webhook están en español y son estables. Los nombres de las herramientas de IA y los errores de MCP están en inglés.
• Nada de esto cambia tu plan, tus precios ni tu facturación: eso se gestiona en el panel. Consulta Seguridad de la cuenta para saber cómo proteger las credenciales.

Documentos relacionados

• Referencia de la API de cliente
• Claves de API de la cuenta
• Webhooks y eventos de cuenta
• Integraciones y notificaciones
• API de IA y MCP
• Recorrido por el panel de cliente

FAQ

¿SolumeCore tiene una API pública?

Sí. La API REST en https://api.solumecore.com/v1 te permite listar tus servicios, controlar la energía y gestionar el firewall de servicios VPS y VDS con una clave de API. Los webhooks, las integraciones y un servidor MCP para asistentes de IA cubren los demás sentidos.

¿Puedo contratar o cancelar servicios con la API?

No con la API REST: cubre el listado, la energía y el firewall. La contratación, la facturación y las cancelaciones se hacen en el panel de cliente.

¿Qué es mejor para notificaciones: webhooks o integraciones?

Usa una integración si quieres Discord, Slack, Telegram, Teams o correo, con filtros y tu propio texto. Usa un webhook si solo necesitas un POST firmado sencillo a tu servidor. Una integración HTTP también te da un POST firmado, con filtros.

¿Hay un SDK?

No hay ningún SDK documentado. La API REST es HTTP y JSON normales, así que sirve cualquier cliente HTTP; los ejemplos de estas guías usan curl, Node.js y Python.

¿Dónde pido ayuda con una integración?

Abre un ticket desde el panel o visita el centro de ayuda. Si se trata de claves de API, indica el nombre de la clave y no pegues nunca el secreto.