Endpoints v1

Base URL: https://api2.monisat.online/v1 · Auth: Authorization: Bearer <jwt>

Auth

POST/v1/auth/login

Body: { email, password }. Retorna jwt_token, company_id.

POST/v1/auth/refresh

Renovar JWT. Body: { refresh_token }.

GET/v1/vehicles

type == "V" para placas, type == "R" para reboques.

GET/v1/drivers

Campos: id, name, cpf.

GET/v1/trips

Query: page, status, vehicle_id, driver_id, policy_id, start_date, end_date.

GET/v1/trips/{id}

Detalhe completo incluindo entregas e situações.

POST/v1/trips

Criar viagem. Campos em inglês snake_case.

PUT/v1/trips/{id}

Atualizar viagem existente.

POST/v1/trips/{id}/analyze

Análise — retorna alertas e confirmações.

GET/v1/delivery-points?_detail=true&nome=...&cnpj=...

name_city_id retorna "CIDADE - UF". Não requer enrich separado.

GET/v1/policies

Campos: id, name, expiration_days (string). Legado usava _id/nome.

GET/v1/profiles

Perfis de viagem.

GET/v1/checklists?_start_from={unix}

_start_from em Unix epoch Int64. name_applicant e name_doer já vêm na lista.

GET/v1/checklists/{id}

Detalhe do checklist.

POST/v1/checklists/schedule

Agendamento com validação PHP-parity.

GET/v1/routes

Rotas cadastradas.

GET/v1/rotograms/{routeId}

data[0].rotogram_route.coordinates + instruções.

POST/v1/disregards

Body: { trip_ids, reason, event_type, location }.

Código	Causa	Solução
400	`_start_from` como ISO 8601	`Int64(date.timeIntervalSince1970)`
401	JWT expirado	`ensureValidTokenForAPICall()`
429	Muitas chamadas paralelas	`RequestThrottle` — máx 3 concorrentes