Quick Start
Faca sua primeira integracao com a API NooviFlow em 5 minutos.
Pre-requisito: NooviFlow instalado e rodando. Veja o guia de instalacao.
1
Fazer login e obter JWT token
curl -X POST "https://flow.seudominio.com/api/auth/login" \
-H "Content-Type: application/json" \
-d '{
"email": "admin@seudominio.com",
"password": "sua_senha"
}'
# Resposta:
# { "token": "eyJhbGciOiJIUzI1NiIs..." }
# Salvar token
export TOKEN="eyJhbGciOiJIUzI1NiIs..."
export BASE_URL="https://flow.seudominio.com"Token JWT
O token expira em 24 horas. Armazene-o de forma segura e faca login novamente quando expirar.
2
Listar clientes
curl -s "$BASE_URL/api/clients" \
-H "Authorization: Bearer $TOKEN" | jq .3
Criar um cliente
curl -X POST "$BASE_URL/api/clients" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Empresa ABC Ltda",
"email": "contato@empresaabc.com.br",
"phone": "+5511999999999",
"document": "12.345.678/0001-90"
}'4
Registrar uma transacao
curl -X POST "$BASE_URL/api/transactions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "income",
"amount": 5000.00,
"description": "Servico de consultoria",
"client_id": "CLIENT_ID",
"date": "2026-02-15",
"category": "servicos"
}'5
Consultar dashboard
curl -s "$BASE_URL/api/kpis/dashboard" \
-H "Authorization: Bearer $TOKEN" | jq .
# Resposta inclui:
# - total_revenue: receita total
# - total_expenses: despesas totais
# - net_income: lucro liquido
# - total_clients: total de clientes
# - pending_invoices: faturas pendentes