JsonToExcel

Conversor JSON para Excel

Uma aplicação FastAPI que converte arquivos JSON para Excel

🚀 Passo a Passo para Execução

1. Clone o repositório

git clone https://github.com/seu-usuario/JsonToExcel.git
cd JsonToExcel

2. Crie um ambiente virtual

Windows

python -m venv venv
venv\Scripts\activate

Linux/Mac

python3 -m venv venv
source venv/bin/activate

3. Instale as dependências

pip install fastapi uvicorn pandas openpyxl jinja2 python-multipart

4. Execute o servidor (escolha uma das opções)

Opção 1 - Usando python

python main.py

Opção 2 - Usando uvicorn

uvicorn main:app –reload

5. Acesse a aplicação

Interface web: http://localhost:8000
Documentação da API: http://localhost:8000/docs

📝 Como usar

Via Interface Web

Acesse http://localhost:8000
Você pode:
- Fazer upload de um arquivo JSON
- Ou colar diretamente o conteúdo JSON no campo de texto
Clique em “Converter” e o arquivo Excel será baixado automaticamente

Via API

A API oferece dois endpoints:

Converter arquivo JSON:

curl -X POST "http://localhost:8000/convert/file/" \
  -H "accept: application/json" \
  -H "Content-Type: multipart/form-data" \
  -F "json_file=@seu_arquivo.json"

Converter texto JSON:

curl -X POST "http://localhost:8000/convert/json/" \
  -H "accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "json_text={\"nome\":\"exemplo\",\"idade\":30}"

✨ Funcionalidades

Conversão de arquivo JSON para Excel
Conversão de texto JSON para Excel
Formatação profissional do Excel
Suporte a JSON aninhado
Mapeamento automático de colunas
Interface web amigável

🛠️ Tecnologias Utilizadas

FastAPI
Pandas
OpenPyXL
Jinja2
Python-Multipart

⚠️ Observações Importantes

Certifique-se de que a porta 8000 não está sendo usada
A pasta uploads será criada automaticamente
Mantenha o arquivo .gitignore para excluir arquivos desnecessários
Python 3.9 ou superior é recomendado

📄 Licença

Este projeto está sob a licença MIT.