https://github.com/danielcalebe/vidaflow-api
https://github.com/danielcalebe/vidaflow-api
Last synced: 3 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/danielcalebe/vidaflow-api
- Owner: danielcalebe
- Created: 2026-05-13T22:26:05.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-07-16T20:17:25.000Z (7 days ago)
- Last Synced: 2026-07-16T22:17:13.304Z (6 days ago)
- Language: Python
- Size: 27.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# VidaFlow API
API REST construída com Flask + SQLAlchemy para treinamento de desenvolvimento backend, autenticação JWT e integração com aplicações mobile/web.
---
# Tecnologias
- Python 3.12+
- Flask
- Flask SQLAlchemy
- Flask Migrate
- Flask JWT Extended
- SQLite
---
# Estrutura do Projeto
```bash
vidaflow_api/
│
├── app/
│ ├── models/
│ ├── routes/
│ ├── services/
│ ├── utils/
│ ├── __init__.py
│ ├── config.py
│ └── extensions.py
│
├── instance/
│ └── database.db
│
├── requirements.txt
├── run.py
└── README.md
```
---
# Requisitos
- Python instalado
- Pip instalado
Verificar versões:
```bash
python --version
pip --version
```
---
# Instalação
## 1. Entrar na pasta do projeto
```bash
cd vidaflow_api
```
---
# Instalar Dependências
```bash
pip install -r requirements.txt
```
---
# Executar API
```bash
python run.py
```
Servidor:
```txt
http://127.0.0.1:5000
```
---
# Banco de Dados
O projeto utiliza SQLite.
O banco é criado automaticamente ao iniciar a API.
Arquivo:
```txt
instance/database.db
```
Caso queira resetar o banco:
1. Delete:
```txt
instance/database.db
```
2. Rode novamente:
```bash
python run.py
```
---
# Rotas Disponíveis
---
## STATUS API
### GET
```http
/v1/status
```
### URL completa
```txt
http://127.0.0.1:5000/v1/status
```
### Resposta
```json
{
"message": "API ONLINE"
}
```
---
# CRIAR USUÁRIO
### POST
```http
/v1/users
```
### URL completa
```txt
http://127.0.0.1:5000/v1/users
```
### Body
```json
{
"name": "Daniel",
"email": "dan@gmail.com",
"password": "123"
}
```
### Resposta
```json
{
"message": "Usuário criado"
}
```
---
# LOGIN
### POST
```http
/v1/login
```
### URL completa
```txt
http://127.0.0.1:5000/v1/login
```
### Body
```json
{
"email": "dan@gmail.com",
"password": "123"
}
```
### Resposta
```json
{
"access_token": "TOKEN_JWT"
}
```
---
# Testes
Recomendado utilizar:
- Postman
- Insomnia
---
# Possíveis Erros
---
## no such table
O banco ainda não foi criado corretamente.
Solução:
1. Feche o servidor
2. Delete:
```txt
instance/database.db
```
3. Rode novamente:
```bash
python run.py
```
---
# Objetivo do Projeto
Este projeto serve para treinamento de:
- APIs REST
- SQLAlchemy ORM
- JWT Authentication
- Arquitetura Flask
- Integração Mobile
- Backend para aplicações React Native
- WorldSkills Mobile Application Development
---
# Autor
Daniel Calebe