API Aedifica

A API REST JSON está disponível em produção em https://api.aedifica.audaces-scale.com/v1. O MCP usa https://api.aedifica.audaces-scale.com/mcp. A documentação destina-se a https://docs.aedifica.audaces-scale.com, ainda sem publicação nesta frente.

A especificação OpenAPI descreve apenas os endpoints implementados. A API usa chaves com âmbitos read/write, paginação por cursor, erros JSON, limites por chave e idempotência transacional em todos os POST.

Recurso	Operações implementadas
projects	GET lista/ID e POST
contacts	GET lista/ID e POST
documents	GET lista/ID, POST rascunho vazio de orçamento/fatura, GET ID/pdf
catalog-items	GET lista/ID e POST
time-entries	GET lista/ID e POST com duração e validação de sobreposição

Não existem endpoints REST para gerir credenciais: owner/admin usam callables Firebase na app. Portal e webhooks têm documentação própria. Pesquisa, relatórios, planeamento REST, importações, edição e finalização continuam propostas nas páginas identificadas como tal. Nenhum endpoint L1 emite documentos, muda numeração fiscal, faz pagamentos ou comunica com AT/Verifactu/AEAT.

Começar por Autenticação e Convenções. Decisões, funções, modelos de dados e entrega operacional em docs/plans/l1-api.md.