API de Inventario de MotorHangar para concesionarios de coches

Cómo funciona

1. 1

   En tu panel de concesionario, abre claves de API y crea una clave. Empieza con mh_ y se muestra una vez.

2. 2

   Envíalo en el encabezado Authorization: Bearer, nunca en la URL, y verifícalo con GET /me.

3. 3

   Publica o actualiza un coche con PUT /vehicles/{id}, usando tu propio id de stock: obtienes 201 la primera vez y 200 después de eso.

4. 4

   Para un stock completo, usa POST /vehicles/sync (hasta 500 coches por llamada); por encima de eso, termina con un POST /vehicles/reconcile.

5. 5

   Lee nuevas conversaciones con compradores usando GET /leads?since=.

Qué sincroniza

• Coches: marca, modelo, año, versión, precio, moneda, kilometraje, combustible, transmisión, color, condición, ciudad, descripción y fotos
• Estado: importando fotos, activo, vendido o retirado
• Leads: la conversación, el coche y un enlace para responder
• El vocabulario de cada mercado con GET /markets/{code}: monedas, combustibles, kilómetros o millas
• Nuestro catálogo de marcas y modelos con GET /catalog/brands

Limitaciones

• Beta: en vivo y documentado, aún no utilizado por un concesionario en producción.
• 120 llamadas por minuto por tecla; una respuesta 429 te dice cuánto esperar.
• La marca y el modelo deben existir en nuestro catálogo. Nunca inventamos modelos.
• Aún no hay webhooks salientes: sondee GET /leads?since= para nuevos leads.