Skip to content

KlebersonCollab/mock-api-builder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ MockForge

MockForge é uma ferramenta poderosa e elegante para criação instantânea de APIs mockadas. Projetada para desenvolvedores que precisam desacoplar o desenvolvimento frontend do backend, permitindo prototipagem rápida com dados realistas, simulação de latência e autenticação.

License Python FastAPI Next.js


Dashboard Preview

✨ Funcionalidades Core

  • 🚀 Criação Instantânea: Crie endpoints REST em segundos com uma URL pública local.
  • 📂 Organização por Coleções: Agrupe seus mocks por projeto ou contexto usando Slugs.
  • ✨ AI Mock Builder: Descreva sua API em linguagem natural e deixe a IA gerar todos os endpoints para você.
  • 📖 OpenAPI / Swagger Support: Importe arquivos Swagger/OpenAPI para criar mocks em massa ou exporte a documentação de suas coleções.

Create Mock Log Viewer
AI Builder

🌟 Funcionalidades Avançadas (Enterprise Ready)

  • 🎭 Respostas Dinâmicas: Use Jinja2 e Faker para gerar dados aleatórios (nomes, emails, datas) a cada requisição.
  • 🔐 Simulação de Auth: Valide headers de autenticação (ex: Bearer Token) diretamente no mock.
  • 📋 Request Inspector: Visualize em tempo real quem está chamando sua API, com logs detalhados de Headers, Query Params e Body.
  • ⏱ Simulação de Latência: Configure delays customizados para testar estados de loading e timeouts no frontend.
  • 🎨 UI Premium: Interface moderna com suporte a Toasts, Modais e feedback visual imediato.

🛠 Tech Stack

Backend

  • FastAPI: Performance e tipagem robusta.
  • SQLModel (SQLite): Persistência leve e eficiente.
  • Jinja2 & Faker: Motor de templates para dados dinâmicos.
  • PyYAML: Suporte a especificações OpenAPI.

Frontend

  • Next.js 14 (App Router): Framework moderno e rápido.
  • TypeScript: Segurança de tipos em todo o código.
  • Monaco Editor: O mesmo editor do VS Code integrado para edição de JSON.
  • Vanilla CSS: Estilização customizada com foco em performance e estética premium.

🚀 Como Rodar o Projeto

O projeto utiliza um Makefile para facilitar todas as operações comuns.

Pré-requisitos

  • Python 3.10+
  • Node.js 18+
  • npm

Setup Inicial

# Instala todas as dependências (Back & Front)
make install

# Inicia o servidor de desenvolvimento
make dev

Comandos Úteis

  • make dev: Sobe o backend (8000) e o frontend (3000).
  • make stop: Para todos os processos.
  • make restart: Reinicia o ambiente.
  • make clean: Remove logs e cache.

📜 Changelog

v1.2.0 (Atual) - Advanced Mocking Update

  • Feature: Integração com Faker e Jinja2 para respostas dinâmicas.
  • Feature: Sistema de Request Logging com visualizador no Dashboard.
  • Feature: Suporte a Importação de OpenAPI 3.0 (JSON/YAML).
  • Feature: Simulação de Authentication Headers.
  • UI/UX: Substituição de alertas nativos por sistema de Toasts e Modais personalizados.
  • UI/UX: Adição de Badges visuais para mocks dinâmicos e protegidos.

v1.1.0 - AI Integration

  • Feature: Implementação do AI Builder (Chat interativo para geração de mocks).
  • Feature: Exportação de documentação Swagger automática por coleção.

v1.0.0 - Initial Release

  • Core: Sistema de CRUD de mocks, suporte a métodos HTTP e códigos de status.
  • Core: Editor JSON integrado (Monaco).

🤝 Contribuindo

  1. Faça um fork do projeto.
  2. Crie uma branch para sua feature (git checkout -b feature/nova-feature).
  3. Comite suas mudanças (git commit -m 'Add: nova funcionalidade').
  4. Dê um push na branch (git push origin feature/nova-feature).
  5. Abra um Pull Request.

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.


Desenvolvido com ⚡ por Antigravity.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors