API-first, e a documentação é pública

O MooverApp não tem uma API privada. O painel em que os nossos clientes trabalham é um cliente da mesma interface pública que o seu código pode chamar: contas, sítios, páginas, blocos, menus, artigos do blogue, media, temas, idiomas e definições são todos recursos, e não há nada que o painel faça que um pedido não faça.

Essa interface está agora documentada em aberto em dev.moover.app: a referência completa, um playground que faz chamadas verdadeiras e ficheiros OpenAPI para as suas próprias ferramentas. Para ler não é preciso conta.

Aprenda um recurso e adivinhe os restantes

Toda a plataforma segue as mesmas regras: cinco métodos padrão em cada recurso, os mesmos nomes de campos, os mesmos parâmetros de paginação, filtragem e ordenação em cada listagem, um formato de erro e uma única forma de dois editores não se sobreporem. Quando o trabalho dura mais do que a chamada — ao criar um sítio novo, por exemplo — recebe uma operação para consultar em vez de uma ligação mantida aberta.

A documentação não se pode desviar

A referência é gerada a partir das declarações com que o próprio serviço é construído, na mesma compilação, e sai na mesma versão. A descrição de um endpoint e o código que lhe responde são um só commit: mude o nome de um campo e a página que o descreve muda com ele, ou a compilação falha. Não há um segundo documento para manter em dia.

Com os exemplos passa-se o mesmo. Os pedidos do quickstart são excertos de um único script que executamos a sério — dez passos de uma conta vazia até uma página num domínio real —, por isso um exemplo partido é uma compilação partida e não um pedido de apoio.

Os seus sítios também são lidos por máquinas

Ser API-first não acaba no editor. Cada sítio que a plataforma publica pode servir ainda uma API de leitura, um gémeo em Markdown de cada página, um endpoint MCP e um catálogo para os descobrir — assim, um assistente a quem perguntam pelo seu conteúdo recebe o conteúdo em vez de raspar a sua maquetação. Cada um deles é um interruptor nas suas definições, ao lado do que diz o que os sistemas de IA podem fazer com o que leem.

Por onde começar

Abra o portal para programadores, corra o quickstart e entre no playground com as mesmas credenciais do painel. Construiu alguma coisa com isto? Diga-nos — lemos o que se constrói na plataforma.