Usar el catálogo de marcas y modelos en tu sitio web

Quien hace tu sitio web puede llenar los desplegables de marca y modelo con el catálogo vehicular de Pitflo, directo desde el navegador del visitante y sin pedirte ninguna llave.

Antes de empezar#

• No necesitas permiso, plan ni configurar nada en Pitflo: las dos direcciones son públicas.
• Lo que necesitas es a quien administra tu sitio o tu formulario: esta página es para entregarle lo que le hace falta.

Pasos#

1. Abre la documentación pública de Pitflo (el enlace «Documentación» de «Integraciones», o la dirección /developers de Pitflo) y, en su menú, entra a «Catálogo vehicular público». No pide sesión.
2. Entrega a quien hace tu sitio las dos direcciones que ahí se documentan: la de las marcas (/public/vehicle-makes) y la de los modelos de una marca (/public/vehicle-models, que pide el identificador de la marca, makeId). Son de solo lectura, no llevan llave ni cabeceras y aceptan llamadas desde cualquier sitio web.
3. Dile cómo se encadenan: primero se piden las marcas, y al elegir una, sus modelos con el makeId que devolvió la primera lista. En las dos, el parámetro q filtra por nombre sin distinguir mayúsculas ni acentos («citroen» encuentra «Citroën»).
4. Comparte los límites que la documentación detalla: cada respuesta trae data y total y lista hasta 500 filas ordenadas por nombre; se admiten 60 peticiones por minuto por dirección de internet, y las respuestas se pueden guardar una hora.

Resultado#

Tu formulario ofrece las mismas marcas y modelos que ve tu taller en Pitflo: las vigentes del catálogo global. Lo que Pitflo retira de su catálogo deja de aparecer en cuanto vence la hora de caché, sin que nadie actualice tu sitio.

Preguntas frecuentes#

¿Necesito la llave del sitio web o una API? No. La llave del sitio sirve para mandar citas a tu agenda; el catálogo vehicular se lee sin llave. Si además quieres recibir las citas, ve Conectar tu sitio web para recibir citas.

¿Es parte de la API /v1? No. No usa token, no tiene campos que elegir ni avisos a tu sistema. Es un catálogo de consulta y nada más.

¿Puedo agregar una marca que me falta? No desde ahí: el catálogo es el global de Pitflo. Si falta una marca o un modelo, pídelo por soporte desde el «?» de cualquier pantalla.

Pidieron los modelos de una marca y respondió con un error 404 («Marca inexistente»). Esa marca no existe o Pitflo la retiró del catálogo. Vuelve a pedir la lista de marcas y usa un identificador vigente.

¿Y las versiones, el motor o el año? Solo salen marcas y modelos. El resto lo captura el cliente, o tu taller al abrir la orden.