Documentação de Integração

"images": [
  { "url": "https://seusite.com.br/fotos/carro-123-1.jpg", "order": 0 },
  { "url": "https://seusite.com.br/fotos/carro-123-2.jpg", "order": 1 },
  { "url": "https://seusite.com.br/fotos/carro-123-3.jpg", "order": 2 }
]

"flags": [
  { "type": "OPTIONAL", "name": "Ar Condicionado",   "value": true },
  { "type": "OPTIONAL", "name": "Direção Elétrica",  "value": true },
  { "type": "OPTIONAL", "name": "Vidros Elétricos",  "value": true },
  { "type": "OPTIONAL", "name": "Teto Solar",         "value": false },
  { "type": "OPTIONAL", "name": "Câmera de Ré",      "value": true },
  { "type": "OPTIONAL", "name": "Sensor de Estac.",  "value": true },
  { "type": "OPTIONAL", "name": "Multimídia",         "value": true },
  { "type": "OPTIONAL", "name": "Bancos em Couro",   "value": false }
]

import crypto from 'crypto';

// No seu servidor que recebe o webhook:
app.post('/webhook/veiculosnosul', (req, res) => {
  const sigHeader = req.headers['x-webhook-signature'];
  const rawBody   = JSON.stringify(req.body);

  // Extrair timestamp e assinatura do header (formato: t=<ts>,v1=<hex>)
  const parts     = Object.fromEntries(sigHeader.split(',').map(p => p.split('=')));
  const timestamp = parts['t'];
  const received  = parts['v1'];

  // Rejeitar mensagens com mais de 5 minutos (proteção contra replay)
  const age = Math.floor(Date.now() / 1000) - parseInt(timestamp, 10);
  if (age > 300) return res.status(401).json({ error: 'Requisição expirada' });

  // Recriar a assinatura esperada: timestamp.rawBody
  const expected = crypto
    .createHmac('sha256', process.env.WEBHOOK_SECRET)
    .update(`${timestamp}.${rawBody}`)
    .digest('hex');

  // Comparação segura contra timing attacks
  if (!crypto.timingSafeEqual(Buffer.from(received, 'hex'), Buffer.from(expected, 'hex'))) {
    return res.status(401).json({ error: 'Assinatura inválida' });
  }

  const { event, externalId, vehicleId, action, error } = req.body;

  if (event === 'vehicle.created') {
    console.log('Veículo criado:', externalId);
  } else if (event === 'vehicle.updated') {
    console.log('Veículo atualizado:', externalId, '| ação:', action);
  } else if (event === 'vehicle.failed') {
    console.error('Falha no sync:', externalId, '| erro:', error);
  }

  res.json({ received: true });
});