Historial de cambios

KernelHost API

Versionado semántico. Los cambios incompatibles (campos renombrados, endpoints eliminados, esquema de autenticación modificado) solo se publican en una nueva versión mayor bajo un nuevo prefijo de URL /v2/. Dentro de /v1/ solo se producen cambios aditivos (nuevos campos opcionales, nuevos endpoints).

v1.4.0 (2026-11-09)

  • Nueva ruta GET /v1/services/{id}/metrics (permiso read:services): métricas del servidor para los periodos 1h, 6h, 24h, 7d y 14d. Los Edge Unlimited Traffic VPS proporcionan datos de CPU, memoria, red y tráfico saliente; los VPS Unlimited Traffic habituales proporcionan datos de red entrante y saliente en las ubicaciones indicadas en la referencia de endpoints.
  • Nuevas rutas GET /v1/services/{id}/ddos/attacks y GET /v1/services/{id}/ddos/attacks/{attack_id} (permiso read:ddos): informes de ataques para Remote DDoS Protection de hasta 90 días, con curva de tráfico y desglose por protocolo, puerto, origen y tamaño de paquete.
  • Perfiles y reglas (/ddos/profiles, /ddos/rules y las operaciones de escritura): un servicio de su cuenta que no sea Advanced DDoS Protection devuelve ahora HTTP 409 not_supported_for_product en lugar de HTTP 404. Los ID de servicio desconocidos o ajenos siguen devolviendo HTTP 404.

v1.3.1 (2026-11-02)

  • Alemania y Francia se pueden elegir por separado: «Alemania (Europa)» sitúa el servidor únicamente en Alemania, en Fráncfort, y «Francia (Europa)» únicamente en Francia.
  • La preparación de los VPS Unlimited Traffic habituales en Europa, Alemania, Francia, Canadá Este, Reino Unido y Polonia puede tardar hasta 7 días. En la mayoría de los casos, el servidor está listo en un plazo de 48 horas. El periodo contratado comienza cuando recibe el servidor.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: consultar perfiles y reglas, añadir reglas y eliminar reglas propias mediante cuatro rutas nuevas. Active expresamente read:ddos y write:ddos; las claves existentes no reciben nuevos permisos.
  • Los límites compartidos entre el panel y la API, los cambios secuenciales y el Idempotency-Key obligatorio en POST y DELETE protegen contra el envío masivo de reglas y las solicitudes paralelas.

v1.2.2 (2026-10-27)

  • POST /v1/orders: si un servicio pagado no se puede aprovisionar de inmediato, su ID aparece ahora en el campo awaiting_setup (status awaiting_setup) y ya no en provisioning_failures con status partial. Se aprovisionará automáticamente en cuanto sea posible y después pasará a active. En ese caso, no vuelva a realizar el pedido.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: nuevas ubicaciones con recargo en Europa, América, Asia, Oriente Medio, África y Australia. GET /v1/products/{id} las lista con su nombre visible y su recargo. Si una de estas ubicaciones está agotada en ese momento, POST /v1/orders devuelve HTTP 409 location_sold_out. Si no se indica ninguna, sigue aplicándose la primera ubicación de la lista (Europe).
  • Las opciones configurables (ubicación y sistema operativo) de los planes Dedicated Unlimited Traffic VPN y Dedicated High Speed Unlimited Traffic VPN tienen nuevos ID, al igual que sus subopciones. Lea los ID desde GET /v1/products/{id}; un ID antiguo fijado en el código devuelve HTTP 400 validation_failed. Para los servicios de estos planes que antes de este cambio tenían status cancelled, terminated o fraud, GET /v1/services/{id} devuelve location con valor null. El High Speed VPN ya solo se puede pedir con las opciones de ubicación Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) y Poland (Europe).
  • Edge Unlimited Traffic VPS: seis nuevas ubicaciones (Frankfurt am Main, Londres, Chester, París, Varsovia y Washington D. C.), hasta 25 en total. Las nuevas ubicaciones tienen sus propios valores sub_option_id; los ID de las ubicaciones existentes no cambian. En algunos planes, el precio base y los recargos por ubicación se reparten de otra forma; los precios totales de las ubicaciones existentes no cambian. Lea siempre los ID y los precios desde GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders para productos con elección de ubicación (Edge Unlimited Traffic VPS): la opción de ubicación no tiene valor predeterminado y debe enviarse en config_options; de lo contrario, HTTP 422 con reason location_required. Una ubicación agotada devuelve HTTP 409 location_sold_out. El nuevo campo opcional storage_gb fija el almacenamiento total entre 20 y 300 GB. 20 GB están incluidos en el precio del plan y se aplican si se omite el campo; cada GB adicional se cobra al precio que indica GET /v1/products/{id}. Otros valores dan HTTP 422 storage_out_of_range.
  • Para estos productos, el resultado del pedido incluye location y storage_gb (almacenamiento total en GB), y GET /v1/products/{id} describe en el campo storage el rango de almacenamiento y el precio por GB adicional. GET /v1/services y GET /v1/services/{id} devuelven location y storage_gb para cada servicio (null si el producto no ofrece esa elección).
  • GET /v1/products/{id} devuelve las subopciones solo con su nombre visible (por ejemplo, "Finland (Europe)"), sin el valor interno que lo precedía. POST /v1/orders rechaza con HTTP 409 out_of_stock los productos que estén agotados en ese momento.

v1.1.0 (2026-09-23)

  • POST /v1/orders: config_options solo acepta opciones y valores visibles en la tienda, y cantidades dentro de sus límites. Las opciones visibles que omita reciben el primer valor de la lista, exactamente como en la tienda. GET /v1/products/{id} solo lista opciones que se pueden pedir y devuelve quantity.min y quantity.max.
  • Nuevo estado de pedido awaiting_setup con el campo awaiting_setup para productos que el equipo de KernelHost configura manualmente. Los servicios aprovisionados automáticamente se aprovisionan exactamente una vez.
  • El cuerpo de las solicitudes está limitado a 64 KB (HTTP 413). Se aplica un límite por cuenta de 120 solicitudes por minuto entre todas las claves, y una cuenta puede tener hasta 20 claves activas. Un fallo de autenticación ya no bloquea ninguna clave y el Idempotency-Key queda vinculado al método y a la ruta.
  • Las peticiones con más de un parámetro en la query string (por ejemplo GET /v1/services?limit=10&offset=0) se rechazaban con HTTP 401. Ahora la firma cubre la query string exactamente como está documentado.

v1.0.0 (2026-05-14)

  • Versión inicial. Los 15 endpoints, autenticación HMAC, almacenamiento de secretos AES-GCM, límites de tasa, idempotencia, registro de auditoría.
  • GET /v1/me, /v1/products, /v1/products/{id}
  • POST /v1/orders, GET /v1/orders/{id}
  • GET /v1/services, /v1/services/{id}, /v1/services/{id}/credentials
  • POST /v1/services/{id}/actions
  • GET /v1/billing/balance, /v1/billing/invoices, /v1/billing/invoices/{id}/pdf
  • GET/PUT /v1/webhooks
  • HMAC-SHA256 signing, AES-256-GCM secret storage, replay protection, idempotency.