La API de Vitrina
Qué expone, con qué credencial se llama y cómo está ordenada esta documentación.
Vitrina es el sistema con el que una automotora administra su stock, sus sucursales y sus conversaciones. Esta API es la parte de ese sistema que puedes llamar desde tu código.
Qué vas a encontrar acá
Cuatro recursos, y son los que necesita alguien que integra por fuera:
| Recurso | Para qué |
|---|---|
| Stock | El lote publicado: listar, filtrar, contar y leer una unidad. |
| Sucursales | Las sucursales de la automotora y la dirección con la que se muestran. |
| API keys | Emitir, listar y revocar las credenciales con las que se llama a todo lo anterior. |
| Errores | El sobre que trae cada falla, y qué hacer con cada código. |
La Referencia tiene el contrato completo de esos recursos, generado desde el mismo documento OpenAPI que emite el backend.
El backend expone bastante más que esto: agentes de IA, conversaciones, agenda, facturación, la vertical de clínicas. Nada de eso está acá todavía, y esa ausencia es deliberada — un endpoint que no documentamos es un endpoint al que no nos comprometimos, y preferimos que lo sepas antes de construir encima.
Lo mínimo para llamar
Todo cuelga de https://api.vitrinadev.com/api/v1 y todo pide la misma credencial:
curl https://api.vitrinadev.com/api/v1/stock/count \
-H "Authorization: Bearer $VITRINA_KEY"{ "data": { "count": 3 } }Las respuestas correctas vienen dentro de data; las fallas, dentro de error. No hay una tercera forma. Eso está en Errores.