Skip to content

fast_deliv API

Plataforma de logística para motoboy — REST API pronta para integrar com CRM, ERP, BI e scripts.

O fast_deliv gerencia o ciclo completo de entregas urbanas: criação pelo admin, aceitação pelo motorista, rastreamento em tempo real e pagamento automático via Pix. Exponha essa operação nos seus sistemas em minutos.

Base URL producao: https://fast-deliv-backend.vercel.app Base URL dev: http://localhost:8000 Auth: Bearer JWT (Supabase) Status: GET /health — retorna {"status": "ok"}

Por onde comecar

Objetivo Link
Primeira request em 5 minutos Inicio Rapido
Entender autenticacao e roles Autenticacao
Referencia completa de endpoints API Reference — Entregas
Exemplos prontos em Python/JS/Shell/Ruby SDKs & Exemplos
Receber notificacoes de pagamento Webhooks
Integrar com CRM Guia CRM
Dashboards no Power BI Guia Power BI

Casos de uso principais

CRM / Gestao de Clientes

Sincronize automaticamente o status de cada entrega no seu CRM. Quando uma entrega muda para completed, dispare automacoes no Salesforce, HubSpot ou qualquer sistema compativel com webhook.

Ver guia CRM

Analytics / BI

Conecte Power BI ou qualquer ferramenta de BI diretamente na API para monitorar volumetria, tempo medio de entrega, ganhos por motorista e outras metricas operacionais.

Ver guia Power BI

Automacao Operacional

Scripts Python ou Shell para criacao de entregas em massa, alertas de SLA e relatorios de conciliacao de pagamentos.

Ver guia Automacao

Endpoints resumidos

Metodo Path Role Descricao
POST /api/v1/deliveries admin Criar entrega
GET /api/v1/deliveries admin Listar entregas
PATCH /api/v1/deliveries/{id}/assign driver Aceitar entrega
PATCH /api/v1/deliveries/{id}/start driver Iniciar coleta
PATCH /api/v1/deliveries/{id}/complete driver Finalizar entrega
PATCH /api/v1/deliveries/{id}/cancel admin Cancelar entrega
GET /api/v1/wallets/me driver Ver carteira
GET /api/v1/wallets/me/transactions driver Historico de transacoes
POST /api/v1/wallets/withdraw driver Solicitar saque Pix
PUT /api/v1/locations/me driver Atualizar GPS
GET /api/v1/locations admin Listar localizacoes
GET /api/v1/drivers admin Listar motoristas
GET /api/v1/pricing admin Config de precos
PUT /api/v1/pricing admin Atualizar precos
POST /api/v1/webhooks/asaas — Webhook ASAAS
GET /health publico Health check

Fluxo de estados

pending --> assigned --> in_progress --> completed
                    \
                     --> cancelled  (admin, qualquer etapa)

Autenticacao rapida

TOKEN=$(curl -s -X POST \
  "https://<PROJECT>.supabase.co/auth/v1/token?grant_type=password" \
  -H "apikey: <ANON_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@empresa.com","password":"senha"}' \
  | jq -r '.access_token')

curl -H "Authorization: Bearer $TOKEN" \
  https://fast-deliv-backend.vercel.app/api/v1/deliveries

Documentacao completa de autenticacao