REST API · v1
Cars
El recurso cars representa un auto publicado. Listalo, leelo, actualizalo y eliminalo desde la API. Soporta filtros por marca, modelo, año, precio, departamento y combustible.
i
Auth requerido — todos los endpoints requieren un header
Authorization: Bearer pcsk_.... Generá una key desde Integraciones.Endpoints
GET/v1/cars
Lista tus autos. Filtros opcionales: ?status=active|draft|sold|archived, ?limit=N (max 200).
GET/v1/cars/:id
Detalle completo del auto incluyendo fotos.
PATCH/v1/cars/:id
Actualiza title, price, currency, description, status, km, color. Requiere scope write.
GET/v1/cars/:id/offers
Ofertas recibidas en el auto (cash, trade, trade_plus_cash).
GET/v1/cars/:id/comments
Preguntas dejadas por visitantes.
GET/v1/cars/:id/analytics
Analítica: totales por tipo, sesiones únicas, vistas diarias, referrers. ?days=30 por default.
Ejemplos
Listar mis autos activos
# filtrar por status
curl "https://api.vendetus.autos/v1/cars?status=active" \
-H "Authorization: Bearer $VND_KEY"
Bajar el precio de un auto
curl-X PATCH https://api.vendetus.autos/v1/cars/<id> \
-H "Authorization: Bearer $VND_KEY" \
-H "Content-Type: application/json" \
-d '{"price": 22000, "currency": "USD"}'
Response
{
"object": "list",
"has_more": true,
"data": [
{
"id": "car_04892",
"slug": "corolla-2019-mvd",
"year": 2019,
"price": 18900,
"currency": "USD",
"status": "active"
}
]
}
Errores
| HTTP | Code | Razón |
|---|---|---|
| 401 | unauthorized | API key faltante o inválida |
| 403 | forbidden | La key no tiene el scope necesario (ej: write) |
| 404 | not_found | Auto no existe o no es de tu cuenta |
| 400 | invalid_request | Body o query params inválidos |
| 429 | rate_limited | Pasaste el límite de requests por minuto |