Escolher um modelo de integração

A inspeção é sempre concluída por uma pessoa autorizada na aplicação TrakarIA. A primeira decisão é quem cria o dossier e prepara a inspeção. A ligação API e um botão de abertura são escolhas independentes.

Modelo	O seu sistema	O operador	Adequado a
Apenas aplicação	Sem API pública e sem reserva sincronizada	Escolhe ou cria o veículo, inicia entrega/devolução e preenche os dados no TrakarIA	Equipa sem integração com software de aluguer
API, sem botão	Sincroniza veículo e dossier no planeamento e prepara as inspeções	Encontra a inspeção preparada no TrakarIA e valida-a	Software ligado; equipa já trabalha no TrakarIA
API com abertura direta	Faz as mesmas chamadas e mostra o launch_url temporário	Abre diretamente o fluxo, inicia sessão e valida	Experiência integrada no seu software

Os ciclos criados apenas na aplicação não se tornam automaticamente dossiers /v1/rentals quando se acrescenta a API mais tarde.

Percurso ligado

1. O backend envia veículo e contexto Rental com a chave do grupo. O Rental surge de imediato no planeamento. Apenas o ID externo do veículo é obrigatório no corpo; o resto pode ser enviado antecipadamente, na entrega ou numa revisão posterior. Faça estas chamadas no servidor.
2. O backend chama POST /v1/rentals/{rental_id}/inspections com departure ou return e Idempotency-Key.
3. A resposta contém o ID da inspeção e launch_url; a sua aplicação pode abri-lo numa nova janela ou por navegação normal.
4. O operador inicia sessão se necessário. O TrakarIA verifica as suas permissões pessoais no grupo.
5. Após validação, o backend recebe um evento assinado ou recupera eventos por GET /v1/events, depois lê o relatório autenticado.

Renove uma ligação expirada com POST /v1/inspections/{inspection_id}/launch. É uma ajuda de navegação, não um token: mantenha-a fora de registos, analytics e páginas públicas. O TrakarIA também pode ser incorporado na sua aplicação; contacte o suporte para rever e autorizar o domínio. Aplicações não aprovadas permanecem bloqueadas.

A sua aplicação pode parar na passagem de controlo

Se a equipa já trabalha no TrakarIA, não precisa do botão. O backend continua a precisar da chave API para sincronizar e preparar. O operador retoma na aplicação TrakarIA. Ao iniciar Checkout sem seleção explícita, o TrakarIA propõe reservas disponíveis do veículo e permite também um Checkout independente para atendimento sem reserva. A associação acrescenta contexto, mas nunca bloqueia a entrega física.

Quando adicionar callbacks

Use webhooks para reação rápida. Verifique, elimine duplicados e obtenha o recurso atual. GET /v1/events assegura recuperação. rental.departure.completed significa JSON inicial pronto; rental.return.completed, comparação pronta. O PDF pode ficar pronto mais tarde.