Changelog da API

Mudanças na API v1 do Faturamento Automático, da mais recente para a mais antiga. Uma mudança aditiva não exige nada de quem já integrou; uma descontinuação mantém o caminho antigo funcionando, mas ele não recebe mais mudanças — migre no seu ritmo.

2026-11-02

POST /v1/usage/credits/publish substitui POST /v1/usage/credits/daily (descontinuação)

• Novo: POST /v1/usage/credits/publish publica o consumo de créditos pré-pagos. É a mesma operação do caminho antigo — mesmo corpo (registro único ou { records: [...] } com até 100 itens, cada um com o próprio usage_date), mesmas respostas (200, 207, 400) e a mesma regra de sobrescrita por conta × produto × dia.
• Descontinuado: POST /v1/usage/credits/daily continua respondendo exatamente como antes, marcado como deprecated na especificação OpenAPI. Não há data de desligamento; integrações novas devem usar /publish.
• Por quê: o CLI kobana deriva o nome de cada comando da rota, e o último segmento de uma ação precisa ser o verbo. credits daily lia como recurso; o comando passa a ser kobana billing usage credits publish.
• MCP: a operação ganha a tool billing_usage_credits_publish, que chama o caminho novo. O caminho descontinuado não tem tool.