Versões e mudanças

Existe uma versão do contrato, 2026-10-03. Ela é a padrão e a mais recente.

Como a versão funciona

• Sem Kernos-Version, vale a mais nova.
• Com Kernos-Version, a API usa a que você pediu e responde no mesmo cabeçalho qual usou. Versão que não existe recusa com version_unknown.
• Os SDKs fixam a versão do contrato com que foram gerados.

2026-10-03

O contrato público inicial.

• 25 rotas públicas, a chave ksk_ com ações e CDs, o limite por chave e o registro de pedidos.
• 6 eventos públicos por webhook assinado, e GET /v1/events para ler os mesmos corpos.
• Acrescentado depois, sem mudar nada do que existia: reenvio de entrega pela API, troca do segredo do webhook com carência (grace_hours, assinatura com dois v1), corpo da resposta no registro da chave de teste e GET /v1/requests/{request_id}.