API de Inventário MotorHangar para concessionárias

A API de Inventário é o que todos os conectores do MotorHangar são baseados, e você pode usá-la diretamente do seu próprio site, DMS ou script. É uma API REST JSON com uma chave por concessionária e uma especificação OpenAPI 3: publique um carro sob seu próprio id de estoque, envie-o novamente para atualizá-lo, marque-o como vendido e leia os compradores que te escreveram.

Criar uma chave de API Leia a documentação da API Especificação OpenAPI 3

Como funciona

No seu painel de dealer, abra chaves API e crie uma chave. Começa com mh_ e é exibida uma vez.
Envie no cabeçalho Authorization: Bearer, nunca na URL, e verifique com GET /me.
Publique ou atualize um carro com PUT /vehicles/{id}, usando seu próprio id de estoque: você recebe 201 na primeira vez e 200 depois.
Para um estoque inteiro, use POST /vehicles/sync (até 500 carros por chamada); acima disso, termine com um POST /vehicles/reconcile.
Leia novas conversas de compradores com GET /leads?since=.

O que sincroniza

Carros: marca, modelo, ano, versão, preço, moeda, quilometragem, combustível, transmissão, cor, condição, cidade, descrição e fotos
Status: importando fotos, ativo, vendido ou retirado
Leads: a conversa, o carro e um link para responder
O vocabulário de cada mercado com GET /markets/{code}: moedas, combustíveis, quilômetros ou milhas
Nosso catálogo de marcas e modelos com GET /catalog/brands

Limitações

Beta: ao vivo e documentado, ainda não usado por um concessionário em produção.
120 chamadas por minuto por chave; uma resposta 429 diz quanto tempo esperar.
Marca e modelo devem existir em nosso catálogo. Nunca inventamos modelos.
Sem webhooks de saída ainda: consulte GET /leads?since= para novos leads.

Perguntas sobre API do MotorHangar

A API é gratuita?

Sim. Os anúncios são gratuitos e a API também; não há nível pago.

O que impede uma exportação ruim de marcar todos os meus carros como vendidos?

Dois guardas. Uma lista vazia nunca é lida como “tudo foi vendido” e se mais de 40% dos carros de uma fonte (e pelo menos cinco) fossem marcados como vendidos de uma vez, nada é marcado e você recebe um 409. Envie allow_mass_sold quando for real.

Meus carros da API irão conflitar com os carros da minha planilha ou plugin?

Não. Cada carro possui uma fonte (api, csv, woocommerce, shopify…) e marcar carros ausentes como vendidos apenas afeta carros da mesma fonte.

Posso importar a especificação para o Postman ou um agente de IA?

Sim. /api/v1/openapi.json é um documento completo OpenAPI 3 com ids de operação e esquemas de resposta, então Postman, Insomnia, n8n, Make e frameworks de agente podem lê-lo.

Os nomes dos produtos pertencem aos seus proprietários. A MotorHangar não está afiliada ou respaldada por eles, e nenhuma dessas integrações está listada em suas lojas de aplicativos ou marketplaces.