Para programadores
API
O sistema da loja avisa cada inclusão, alteração ou venda na hora. Precisa de programador.
Passo a passo
Passo 1: Gere a chave
Em Integrações › API, clique em “Gerar chave para o programador”. Ela aparece uma vez só: copie.

Passo 2: Envie ao programador
Mande a mensagem pronta, com os códigos da loja. A chave vai separada, por um canal seguro.

Passo 3: Acompanhe os eventos
Cada envio aparece em “Eventos recebidos”. Se algum for recusado, o motivo aparece ao lado.

Passo 4: Publique os carros novos
Eles chegam como rascunho. Em Meu estoque, clique em “Publicar todos os rascunhos”.
Problemas comuns
- HTTP 401
- Chave ausente ou desligada. Gere outra chave no painel.
- HTTP 409
- O mesmo eventId veio com conteúdo diferente. Use um eventId novo por mudança.
- HTTP 400
- Algum campo está fora do contrato. A resposta diz qual e por quê.
Para desenvolvedores
API de eventos · versão 1.0
Gere a chave no painel (Integrações › API) e envie um evento para cada inclusão, alteração ou venda. Resposta HTTP 202 com recibo; o processamento é assíncrono e idempotente.
POST https://carrodaqui.com.br/integrations/v1/inventory/events
Authorization: Bearer SUA_CHAVE
Content-Type: application/json
{
"schemaVersion": "1.0",
"eventId": "b1ac0961-34c4-41ca-a71e-1a5f9e7a82dc",
"storeId": "ID_DA_LOJA",
"connectionId": "ID_DA_ORIGEM",
"occurredAt": "2026-10-19T14:30:00Z",
"vehicle": {
"externalId": "EST-123",
"sourceVersion": "1",
"availability": "AVAILABLE",
"make": "Chevrolet",
"model": "Onix",
"version": "LT 1.0 Turbo",
"manufactureYear": 2023,
"modelYear": 2024,
"amountInCents": "7499000",
"mileageKm": 42000,
"bodyType": "HATCHBACK",
"fuel": "FLEX",
"transmission": "AUTOMATIC",
"color": "Prata",
"features": "Ar-condicionado, Câmera de ré, Central multimídia",
"conditions": [
"UNICO_DONO",
"IPVA_PAGO"
],
"photos": [
"https://cdn.sualoja.com.br/onix-frente.jpg"
]
}
}- storeId e connectionId aparecem no painel da loja, na aba API, junto da chave.
- externalId identifica o veículo na origem; sourceVersion é um inteiro crescente em texto. Versões antigas são ignoradas.
- Categorias (
bodyType): HATCHBACK, SEDAN, SUV, PICKUP, VAN, SPORT, OTHER, MOTORCYCLE, TRUCK ou BOAT. Câmbio: MANUAL, AUTOMATIC ou NONE (embarcações). - Preços em centavos como texto. Fotos e vídeo em URLs HTTPS públicas.
- Venda ou retirada:
availabilitySOLD ou UNAVAILABLE. Para voltar, AVAILABLE com versão superior. - Reenvio seguro: mesmo eventId e mesmo conteúdo devolvem o mesmo recibo; conteúdo diferente recebe HTTP 409.
- Carros novos chegam como rascunho; a loja publica no painel.