API Aufix

Acesso programático a veículos, despesas, lembretes, membros da frota e atividade. Base URL: https://api.aufix.app.

Visão geral

  • All REST routes are under /v1/….
  • Successful responses use { "data": … }.
  • Errors use { "error": { "code": "…", "message": "…" } }.
  • Operational routes require an active Fleet plan (Fleet, Fleet Pro, or Fleet Max).
  • Personal access tokens (PAT) are rate-limited; responses may include Retry-After.

Autenticação

HTTPRecursoDescrição
—Authorization: Bearer …Todas as rotas abaixo exigem um token de acesso pessoal: Authorization: Bearer aufix_pat_…. Crie e revogue chaves em Definições → Integrações (o segredo é mostrado apenas uma vez). read — apenas GET; write — todos os métodos.

Veículos

HTTPRecursoDescrição
GET/v1/vehiclesLista os veículos acessíveis. Query: limit, cursor after.
POST/v1/vehiclesCria um veículo na sua garagem.
GET/v1/vehicles/:vehicleIdObtém um veículo.
PATCH/v1/vehicles/:vehicleIdAtualiza os campos de um veículo.
DELETE/v1/vehicles/:vehicleIdElimina um veículo e os registos associados (proprietário).

Atualizações do veículo

HTTPRecursoDescrição
GET/v1/vehicles/:vehicleId/updatesLista as atualizações de estado (quilometragem, combustível/carga, condição, pneus, comentário). Query: limit, afterId + afterAt.
POST/v1/vehicles/:vehicleId/updatesRegista uma nova atualização de um veículo.

Despesas

HTTPRecursoDescrição
GET/v1/expensesLista as despesas (das mais recentes para as mais antigas). Query: limit, vehicleId, cursor afterId + afterValue.
POST/v1/expensesCria uma despesa para um veículo ou uma despesa pessoal sem veículo.
PATCH/v1/expenses/:expenseIdAtualiza uma despesa.
DELETE/v1/expenses/:expenseIdElimina uma despesa.

Lembretes

HTTPRecursoDescrição
GET/v1/remindersLista os lembretes por data de vencimento. Query: limit, vehicleId, cursor afterId + afterValue.
POST/v1/remindersCria um lembrete para um veículo ou um lembrete pessoal.
PATCH/v1/reminders/:reminderIdAtualiza os campos de um lembrete (incluindo o estado de concluído, quando suportado).
DELETE/v1/reminders/:reminderIdElimina um lembrete.

Atividade

HTTPRecursoDescrição
GET/v1/activityRegisto de atividade do proprietário da frota. Query: limit, cursor afterId + afterAt.

Frota

HTTPRecursoDescrição
GET/v1/fleet/membersLista os membros da frota, as funções e as atribuições de veículos.
GET/v1/fleet/invitesLista os convites da frota. Devolve inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired.