Versionamento semântico. Breaking changes (campos renomeados, endpoints removidos, esquema de autenticação alterado) ocorrem somente em uma nova versão major, sob novo prefixo de URL /v2/. Dentro de /v1/ acontecem apenas mudanças aditivas (novos campos opcionais, novos endpoints).

v1.4.0 (2026-11-09)

  • Nova rota GET /v1/services/{id}/metrics (permissão read:services): métricas do servidor para os períodos 1h, 6h, 24h, 7d e 14d. Os Edge Unlimited Traffic VPS fornecem dados de CPU, memória, rede e tráfego de saída; os VPS Unlimited Traffic da gama habitual fornecem dados da rede de entrada e de saída nas localizações indicadas na referência de endpoints.
  • Novas rotas GET /v1/services/{id}/ddos/attacks e GET /v1/services/{id}/ddos/attacks/{attack_id} (permissão read:ddos): relatórios de ataques para Remote DDoS Protection de até 90 dias, com curva de tráfego e repartição por protocolo, porta, origem e tamanho de pacote.
  • Perfis e regras (/ddos/profiles, /ddos/rules e as operações de escrita): um serviço da sua conta que não seja Advanced DDoS Protection devolve agora HTTP 409 not_supported_for_product em vez de HTTP 404. IDs de serviço desconhecidos ou de outra conta continuam a devolver HTTP 404.

v1.3.1 (2026-11-02)

  • Pode escolher a Alemanha e a França separadamente: «Alemanha (Europa)» mantém o servidor apenas na Alemanha, em Frankfurt, e «França (Europa)» apenas em França.
  • Nos VPS Unlimited Traffic da gama habitual, nas localizações Europa, Alemanha, França, Canadá Oriental, Reino Unido e Polónia, a disponibilização pode demorar até 7 dias. Na maioria dos casos, o servidor fica pronto em 48 horas. O período faturado só começa quando recebe o servidor.

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection: consultar perfis e regras, adicionar regras e eliminar regras próprias através de quatro novas rotas. Ative explicitamente read:ddos e write:ddos; as chaves existentes não recebem novas permissões.
  • Limites partilhados entre o painel e a API, alterações sequenciais e Idempotency-Key obrigatório em POST e DELETE protegem contra o envio massivo de regras e os pedidos em paralelo.

v1.2.2 (2026-10-27)

  • POST /v1/orders: se um serviço pago não puder ser aprovisionado de imediato, o seu ID aparece agora no campo awaiting_setup (status awaiting_setup) e já não em provisioning_failures com status partial. Será aprovisionado automaticamente assim que for possível e depois passará para active. Neste caso, não volte a fazer a encomenda.

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN: novas localizações com acréscimo na Europa, nas Américas, na Ásia, no Médio Oriente, em África e na Austrália. GET /v1/products/{id} lista-as com o nome de apresentação e o acréscimo. Se uma dessas localizações estiver esgotada nesse momento, POST /v1/orders devolve HTTP 409 location_sold_out. Sem indicação, continua a aplicar-se a primeira localização listada (Europe).
  • As opções configuráveis (localização e sistema operativo) dos planos Dedicated Unlimited Traffic VPN e Dedicated High Speed Unlimited Traffic VPN têm novos IDs, tal como as respetivas subopções. Leia os IDs em GET /v1/products/{id}; um ID antigo fixado no código devolve HTTP 400 validation_failed. Para os serviços destes planos cujo campo status já tinha o valor cancelled, terminated ou fraud antes desta alteração, GET /v1/services/{id} devolve location com o valor null. O High Speed VPN passa a poder ser encomendado apenas com as opções de localização Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) e Poland (Europe).
  • Edge Unlimited Traffic VPS: seis novas localizações (Frankfurt am Main, Londres, Chester, Paris, Varsóvia e Washington DC), até 25 no total. As novas localizações têm valores sub_option_id próprios, os IDs das localizações existentes mantêm-se. Em alguns planos, o preço base e os acréscimos por localização estão repartidos de outra forma, os preços totais das localizações existentes mantêm-se. Leia sempre os IDs e os preços em GET /v1/products/{id}.

v1.2.0 (2026-10-24)

  • POST /v1/orders para produtos com escolha de localização (Edge Unlimited Traffic VPS): a opção de localização não tem valor predefinido e tem de ser enviada em config_options, caso contrário HTTP 422 com reason location_required. Uma localização esgotada devolve HTTP 409 location_sold_out. O novo campo opcional storage_gb define o armazenamento total entre 20 e 300 GB. 20 GB estão incluídos no preço do plano e aplicam-se se o campo for omitido; cada GB adicional é cobrado ao preço indicado em GET /v1/products/{id}. Outros valores dão HTTP 422 storage_out_of_range.
  • Para estes produtos, o resultado da encomenda inclui location e storage_gb (armazenamento total em GB), e GET /v1/products/{id} descreve no campo storage o intervalo de armazenamento e o preço por GB adicional. GET /v1/services e GET /v1/services/{id} devolvem location e storage_gb para cada serviço (null se o produto não tiver essa escolha).
  • GET /v1/products/{id} devolve as subopções apenas com o nome de apresentação (por exemplo "Finland (Europe)"), sem o valor interno que o precedia. POST /v1/orders recusa com HTTP 409 out_of_stock os produtos que estejam esgotados nesse momento.

v1.1.0 (2026-09-23)

  • POST /v1/orders: config_options só aceita opções e valores visíveis na loja e quantidades dentro dos respetivos limites. As opções visíveis que omitir recebem o primeiro valor listado, exatamente como na loja. GET /v1/products/{id} lista apenas opções encomendáveis e devolve quantity.min e quantity.max.
  • Novo estado de encomenda awaiting_setup com o campo awaiting_setup para produtos que a equipa KernelHost configura manualmente. Os serviços aprovisionados automaticamente são aprovisionados exatamente uma vez.
  • Os bodies dos pedidos estão limitados a 64 KB (HTTP 413). Aplica-se um limite de 120 pedidos por minuto por conta, em todas as chaves, e uma conta pode ter até 20 chaves ativas. Uma autenticação falhada já não bloqueia nenhuma chave e o Idempotency-Key fica associado ao método e ao caminho.
  • Os pedidos com mais de um parâmetro na query string (por exemplo GET /v1/services?limit=10&offset=0) eram rejeitados com HTTP 401. A assinatura passa a abranger a query string exatamente como documentado.

v1.0.0 (2026-05-14)

  • Lançamento inicial. Todos os 15 endpoints, autenticação HMAC, armazenamento de segredos AES-GCM, limites de taxa, idempotência, log de auditoria.
  • 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.