Documentação técnica

API Estepcon

A API do Estepcon é RESTful, retorna JSON e usa JWT Bearer para autenticação. Base URL: https://api.estepcon.app/v1

Autenticação rápida

# 1. Obter token

curl -X POST https://api.estepcon.app/v1/auth/authenticate \

-H "Content-Type: application/json" \

-d '{"email":"seu@email.com","password":"senha"}

# 2. Usar nas requisições

curl https://api.estepcon.app/v1/customers \

-H "Authorization: Bearer SEU_TOKEN"

REST

JWT com access token (30 min) e refresh token (7 dias). Autenticação separada para portal do cliente.

REST

CRUD completo de clientes e veículos. Multi-tenant por companyId derivado do JWT.

REST

Gerenciamento completo de OS, itens, status e histórico de atendimentos.

Webhook

Receba eventos em tempo real: nova OS, mudança de status, novo agendamento. Verificação HMAC-SHA256.

POST/auth/authenticateAutenticar usuário (email + senha)

POST/auth/refreshRenovar access token com refresh token

GET/customersListar clientes com filtros e paginação

POST/work-ordersCriar nova ordem de serviço

PATCH/work-orders/:id/statusAtualizar status da OS

GET/finance/transactionsListar lançamentos financeiros

PATCH/finance/transactions/:id/partial-paymentRegistrar pagamento parcial

GET/appointmentsListar agendamentos por período

GET/inventory/productsListar produtos do estoque

Nossa equipe de suporte técnico responde em até 24h.