Autenticação

Todas as rotas exigem HTTP Basic Auth, utilizando valores personalizados e únicos de cada cliente, cadastrados em nossa base. Ficou com dúvidas, fale com suporte@guesstecnologia.com.br.

Identificador do laudo (id)

As duas rotas abaixo recebem o mesmo id: uma string em Base64 contendo o agendamento e a vistoria separados por |, no formato:

Base64("{idAgendamento}|{idVistoria}")

GET /api/laudo/gerar/{id}

Dispara a geração assíncrona do PDF em background e retorna imediatamente.

Resposta

{
  "sucesso": true,
  "mensagem": "Solicitação de geração recebida e em processamento.",
  "laudo": "12345_6789.pdf",
  "cliente": "Razão Social do Cliente",
  "solicitadoEm": "18/08/2026 09:30:00"
}

GET /api/laudo/consultar/{id}

Verifica o status atual do laudo no armazenamento.

Resposta

{
  "existe": true,
  "status": "pronto",
  "laudo": "12345_6789.pdf",
  "cliente": "Razão Social do Cliente",
  "mensagem": "Laudo disponivel para download."
}

status pode ser inexistente criando pronto

Fluxo recomendado

1. Chamar consultar. Se status = pronto, baixar o laudo diretamente.
2. Se status = criando, aguardar e repetir a consulta periodicamente.
3. Se status = inexistente, chamar gerar e então repetir a consulta até pronto.

Identificador da contestação (id)

As rotas abaixo recebem apenas o ID da vistoria — a contestação é localizada automaticamente a partir dela. O id é uma string em Base64, no formato:

Base64("{idVistoria}")

GET /api/contestacao/gerar/{id}

Dispara a geração assíncrona do PDF da contestação em background e retorna imediatamente.

Resposta

{
  "sucesso": true,
  "mensagem": "Solicitação de geração recebida e em processamento.",
  "laudo": "CONST_6789.pdf",
  "cliente": "Razão Social do Cliente",
  "solicitadoEm": "18/08/2026 09:30:00"
}

GET /api/contestacao/consultar/{id}

Verifica o status atual da contestação no armazenamento.

Resposta

{
  "existe": true,
  "status": "pronto",
  "laudo": "CONST_6789.pdf",
  "cliente": "Razão Social do Cliente",
  "mensagem": "Contestação disponivel para download."
}

status pode ser inexistente criando pronto

Armazenamento

O PDF da contestação é salvo na mesma pasta da vistoria relacionada, com o prefixo CONST_ no nome do arquivo — segue o mesmo fluxo de consultar → gerar → repetir usado na API de Laudos.