Como nasceu a Fake API: minha API REST open source para prototipar mais rápido (Node.js + Express)
Como nasceu a Fake API (e por que ela pode acelerar seus protótipos):
Eu criei a Fake API para não depender do back-end quando preciso validar ideias de UI/UX.
É open source (MIT), feita em Node.js + Express, com CRUD dinâmico, busca, paginação, validação, CORS e health checks — tudo pronto para usar.
- Site: https://fakeapi.aioher.com
- Repositório:https://github.com/samuelikz/fakeapi
O problema que eu queria resolver
- Quantas vezes você já travou um protótipo porque “o back-end ainda não ficou pronto”?
- Eu vivia isso. Em páginas simples, eu só queria **listar, buscar, paginar e salvar** dados falsos. Mas cada PoC virava um mini-back-end descartável.
- Hoje a utilizo na minha própria equipe de desenvolvedores.
Eu queria três coisas:
- Começar em minutos, sem reescrever o mundo.
- Comportamento previsível (filtros, paginação, erros, CORS).
- Evoluir com qualidade, sem ficar preso a um mock inflexível.
O que a Fake API entrega
- CRUD dinâmico por recurso (`/posts`, `/users`, etc.)
- Busca textual com `?q=...`
- Paginação com `_page` e `_limit` (+ header `X-Total-Count`)
- Metadados opcionais com `?_meta=1` → `{ data, meta }`
- Validação básica e tratamento de erros padronizado
- CORS configurável
- Logs com timestamps
- Health checks: `/health`, `/health/detailed`, `/health/ready`, `/health/live`, `/health/ping`
- UI web para apontar a Base URL, listar recursos e copiar exemplos
Como contribuir (hoje estou publicando ela para a comunidade contrubuir comigo)
- Fork
- git checkout -b feature/minha-feature
- git commit -m "feat: descreva sua mudança"
- git push origin feature/minha-feature
- Pull Request no repositório
Dicas: mantenha o código limpo/testável, siga o padrão do projeto, inclua testes e docs quando mudar comportamentos.
