Em parte, e a nuance conta. Cada aplicação gerada expõe uma API REST completa — uma família de rotas por tipo de dado — mas está protegida pelo cookie de sessão: ainda não existe uma chave de API que permita a outro programa ligar-se sozinho. Sem escrever uma linha, dispõe no entanto da exportação em JSON e CSV de cada conjunto de dados, da importação de ficheiros nos dados de medição e do acesso direto à base se alojar por si próprio. E como o código lhe pertence, acrescentar uma chave de API continua a ser um trabalho corrente.
O que a aplicação expõe realmente
Uma aplicação gerada não é uma interface pousada sobre uma base opaca: é construída como uma aplicação web normal, com uma API REST por trás dos seus ecrãs. Para cada tipo de dado descrito no seu pedido, o motor emite a mesma família de rotas: listar e criar, depois ler, alterar e eliminar um registo preciso. Aliás, uma eliminação não apaga nada em definitivo — passa pela reciclagem, e existe uma rota de restauro para a anular.
Estas rotas não são um extra opcional: são exatamente as que os próprios ecrãs da aplicação utilizam. Não há, portanto, de um lado uma «verdadeira» API interna e do outro uma API pública empobrecida — é a mesma, e está no código que leva consigo.
O limite a conhecer: hoje não há chave de API
Assim que uma aplicação exige uma autenticação — o caso por omissão para dados de gestão —, as suas rotas ficam protegidas: cada chamada tem de transportar o cookie de sessão assinado emitido na autenticação, e a uma conta apenas de leitura é recusada qualquer escrita do lado do servidor, seja qual for o caminho.
Essa proteção tem uma consequência direta, que é melhor conhecer antes de decidir: hoje não existe nem chave de API nem token que permita a outro programa autenticar-se sozinho, sem navegador. Uma ferramenta de terceiros não pode, por isso, consultar a aplicação de máquina para máquina tal como está. Preferimos escrevê-lo com clareza a deixar que «a aplicação tem uma API» sugira mais do que há.
O que funciona sem escrever uma linha
O ecrã Definições propõe a exportação de cada conjunto de dados, em formato JSON ou CSV. É o caminho mais curto para uma folha de cálculo, uma ferramenta de relatórios ou um contabilista: os dados saem quando o decidir, em formatos que toda a gente lê.
No sentido inverso, os dados de medição — leituras, trajetos, séries produzidas por um aparelho — recebem uma rota e um botão de importação de ficheiros: CSV, e GPX para os trajetos. Por fim, se alojar a aplicação por si próprio, a sua base PostgreSQL é sua: uma ferramenta de relatórios pode lê-la diretamente, sem passar pela API.
Se precisar de uma integração completa
O essencial a reter é que nenhum destes limites é um cadeado. A aplicação é um projeto Next.js e Prisma normal, exportável em ZIP ou enviado para o seu repositório GitHub: acrescentar autenticação por chave de API a rotas que já existem é um trabalho bem balizado para um programador, sobre código legível.
É essa a diferença face a uma ferramenta cuja integração depende de um conector que o fornecedor oferece ou não. Aqui a pergunta nunca é «a plataforma vai permitir?», mas apenas «quem o escreve?» — e no dia em que o fizer, não tem de pedir nada a ninguém.