{"success":true,"data":{"contract":{"version":"v1","openapi_version":"1.1.0","stability":"frozen","frozen_since":"2026-08-06","policy":["Rotas, métodos HTTP, escopos e formato de erro/sucesso já publicados em /api/v1 não sofrem mudanças breaking.","Campos novos em respostas são sempre opcionais (aditivos).","Remoção, renomeação ou mudança de significado de campo/rota exige uma futura /api/v2.","Escopos novos podem ser adicionados; escopos existentes mantêm o mesmo significado."],"docs":{"human":"/docs-api.html","changelog":"/api-changelog.html","openapi":"/api/v1/openapi.json","changelog_json":"/api/v1/changelog"}},"changelog":[{"date":"2026-08-06","version":"1.1.0","type":"additive","title":"Métricas de uso da API (painel)","changes":["GET /api/empresa/api-requests/metricas — agrega por status, rota, api_key e hora.","Master: GET /api/master/empresas/:id/api-requests/metricas.","Painel Observabilidade: cards de req/min, erros e breakdowns.","Reusa api_request_logs; sem breaking changes em /api/v1."]},{"date":"2026-08-06","version":"1.1.0","type":"additive","title":"Observabilidade API (painel)","changes":["Tabela api_request_logs + middleware nas rotas autenticadas /api/v1.","Painel: GET /api/empresa/api-requests e /resumo; entregas de webhook no UI.","Master: GET /api/master/empresas/:id/api-requests e webhook-entregas.","Sem breaking changes no contrato público da API."]},{"date":"2026-08-06","version":"1.1.0","type":"additive","title":"Congelamento do contrato v1 + OpenAPI alinhado","changes":["Política oficial: v1 congelada (sem breaking changes).","Endpoint público GET /api/v1/changelog.","OpenAPI 1.1.0 com tags, escopos, OAuth, notas, cadastros, cobranças e contratos.","Páginas /docs-api.html e /api-changelog.html sincronizadas."]},{"date":"2026-08-05","version":"1.1.0","type":"additive","title":"Cobranças, contratos e catálogo de escopos","changes":["Novos escopos: cobrancas:* e contratos:*.","Rotas /api/v1/cobrancas e /api/v1/contratos.","GET /api/v1/scopes (catálogo público com labels).","UI de API Keys com seleção de escopos por checkbox/chip."]},{"date":"2026-07-01","version":"1.0.0","type":"baseline","title":"Baseline da API v1","changes":["Auth por X-Api-Key (fnfe_*) e Bearer (integração/OAuth).","Notas NF-e/NFS-e: emitir, listar, consultar, XML, PDF, cancelar.","Clientes e produtos (cadastros).","Idempotency-Key na emissão, rate limits e webhooks outbound."]}]}}