Pular para o conteúdo
HalverHalverDocumentação Halver

Changelog da API

As mudanças na API pública, da mais recente para a mais antiga. Veja também Versionamento.

2026-10-23

Seção intitulada “2026-10-23”
  • Referências do revendedor no servidor: external_id (o id do pedido, único na conta entre os servidores não removidos) e end_customer_ref (o id do cliente final), ids opacos sem dado pessoal, no deploy, no PATCH /cloud/servers/{id} e em todo servidor devolvido. Um external_id repetido responde 409 cloud.external_id_taken com existing_id (Erros).
  • Filtros external_id e end_customer_ref em GET /cloud/servers, GET /cloud/operations e GET /portal/invoices (Paginação).

2026-10-20

Seção intitulada “2026-10-20”

Primeira versão pública da documentação da API, com a referência gerada da especificação OpenAPI e estes recursos:

  • Tokens de API com escopos finos, criados em Desenvolvedores › Tokens de API (Autenticação e escopos).
  • Servidores: catálogo, deploy, energia, próximo boot, reinstalação, limpeza, cancelamento no fim do período e desfazer o cancelamento.
  • User data do cloud-init no deploy e na reinstalação: #cloud-config ou script, até 64 KiB, em texto ou base64; a API devolve só user_data_sha256 e user_data_size (User data).
  • Idempotency-Key nos POST que criam ou cobram, com Idempotent-Replayed: true na repetição (Idempotência).
  • Paginação por cursor (limit, cursor, next_cursor) em servidores, chaves SSH, redes privadas, IPs elásticos e operações, e filtros de servidores por status, site_id, plan_id, hostname_prefix e tag (Paginação).
  • PATCH /cloud/servers/{id} para mudar hostname, tags e descrição sem tocar na máquina.
  • GET e PATCH /cloud/ssh-keys/{id} para ver e renomear uma chave SSH.
  • Operações (GET /cloud/operations e GET /cloud/operations/{id}) como contrato de espera do deploy, da reinstalação, da limpeza e da remoção, com Retry-After (Operações assíncronas).
  • Redes privadas e IPs elásticos com escopos próprios: networks:read, networks:write, ips:read e ips:write.
  • Console serial e VPN da IPMI com o escopo servers:console (Console serial).
  • Cabeçalhos RateLimit-Policy e RateLimit em toda resposta a um token, e 429 com Retry-After (Limites de uso).
  • Erros em application/problem+json com code estável (Erros).
  • Servidor MCP em https://dash.halver.com.br/mcp (Servidor MCP).