Changelog de la API

Cambios en la API v1 de Faturamento Automático, del más reciente al más antiguo. Un cambio aditivo no exige nada de quien ya integró; una descontinuación mantiene la ruta antigua funcionando, pero ya no recibe cambios — migra a tu ritmo.

2026-11-02

POST /v1/usage/credits/publish sustituye a POST /v1/usage/credits/daily (descontinuación)

• Nuevo: POST /v1/usage/credits/publish publica el consumo de créditos prepagos. Es la misma operación de la ruta antigua — mismo cuerpo (registro único o { records: [...] } con hasta 100 ítems, cada uno con su propio usage_date), mismas respuestas (200, 207, 400) y la misma regla de sobrescritura por cuenta × producto × día.
• Obsoleto: POST /v1/usage/credits/daily sigue respondiendo exactamente como antes, marcado como deprecated en la especificación OpenAPI. No hay fecha de apagado; las integraciones nuevas deben usar /publish.
• Por qué: el CLI kobana deriva el nombre de cada comando de la ruta, y el último segmento de una acción debe ser el verbo. credits daily se leía como recurso; el comando pasa a ser kobana billing usage credits publish.
• MCP: la operación gana la tool billing_usage_credits_publish, que llama a la ruta nueva. La ruta obsoleta no tiene tool.