API — Fretes

Consulta e atualização de status.

GET /freights/:id

Retorna os dados completos de um frete.

bash

curl https://freteflow.fr.com.br/api/public/v1/freights/FR-1234 \
  -H "X-API-Key: ff_live_xxx..."

json

{
  "id": "FR-1234",
  "status": "in_transit",
  "visibility": "publico",
  "public_slug": "a1b2c3d4",
  "origin": { "city": "São Paulo", "state": "SP" },
  "destination": { "city": "Rio de Janeiro", "state": "RJ" },
  "price": 5500.00,
  "carrier": { "id": "...", "name": "Transportes ABC" },
  "driver": { "name": "João Silva", "phone": "+5511999999999" },
  "created_at": "2026-05-01T12:34:56Z"
}

PATCH /freights/:id/status

Atualiza o status de um frete.

bash

curl -X PATCH https://freteflow.fr.com.br/api/public/v1/freights/FR-1234/status \
  -H "X-API-Key: ff_live_xxx..." \
  -H "Content-Type: application/json" \
  -d '{"status":"delivered","note":"Entregue 14:20"}'

Status válidos:

draft, published, negotiating
assigned, picked_up, in_transit
delivered, cancelled