Listing
L'oggetto listing rappresenta l'annuncio pubblicato dal concessionario. Ogni annuncio è legato ad un Dealer ed ad una sede.
L'annuncio contiene l'oggetto vehicle contente tutte le informazioni del veicolo caricato sull'annuncio.
POST
GET
PATCH
DELETE
L'oggetto vehicle
Attributi
detail object
Dettagli del veicolo:
- body: tipologia carrozzeria — valori possibili: sedan, suv, minivan, coupe, city_car, convertible, station_wagon, pickup, commercial_vehicle
- seats: numero di posti a sedere
- doors: numero di porte
- externalType: tipo di vernice esterna — valori: metallic, pastel, pearlescent, matte, wrapping, other
- externalColor: colore esterno — valori: beige, blue, brown, bronze, yellow, gray, green, red, black, silver, purple, white, orange, gold
- externalColorSpecificName: nome specifico del colore
- internalType: tipo di rivestimento interno — valori: alcantara, fabric, total_leather, partial_leather, suede, other
- internalColor: colore degli interni — valori: beige, black, gray, brown, white, blue, red, green, yellow, orange, other
- options: array di optional (es. ABS, climatizzatore...)
engine object
Specifiche del motore:
- drivetrain: trazione — valori: front, rear, four_wheel
- gearbox: tipo di cambio — valori: manual, automatic
- power: potenza in kW
- gears: numero di marce
- cylinders: numero di cilindri
- capacity: cilindrata in cc
- netWeight: peso netto in kg
- tank: capacità del serbatoio in litri
environment object
Informazioni ambientali:
- fuel: tipo carburante — valori: diesel, petrol, electric, gpl, methane, hydrogen, petrol_electric, diesel_electric
- combinedConsumption: consumo combinato
- combinedEmissions: emissioni CO2
- emissionClass: classe ambientale — valori: 6E, 6D, 6C, 6B, 6T, E6, E5, E4, E3, E2, E1, E0, ZE
equipment object
Al momento non utilizzato
status object
Stato del veicolo:
- category: categoria veicolo — valori: used, km0, new
- km: chilometri percorsi
- previousOwners: numero di proprietari precedenti
- registrationDate: data immatricolazione
- damaged: danneggiato
- documentedCheckup: tagliando documentato
- priceNegotiable: prezzo trattabile
- vatExposed / vatIncluded: IVA esposta/inclusa
plate string
Targa del veicolo (opzionale).
vin string
Numero di telaio.
warranty enum
Tipo di garanzia — valori: audi_prima_scelta, arval_autoselect
{
"detail": {
"body": "suv",
"seats": 5,
"doors": 5,
"externalType": "metallic",
"externalColor": "black",
"options": [
"ABS",
"Climatizzatore",
"Controllo automatico clima",
"Sistema di navigazione",
"Sedili riscaldati",
"Regolazione elettrica sedili",
"Alzacristalli elettrici",
"Airbag",
"Airbag Passeggero",
"Airbag laterali",
"Chiusura centralizzata",
"Immobilizzatore elettronico",
"Controllo trazione",
"Cerchi in lega",
"Boardcomputer",
"Servosterzo",
"Autoradio",
"ESP",
"Hill holder",
"Volante multifunzione",
"Bluetooth",
"Vivavoce",
"Isofix",
"USB",
"Start/Stop Automatico",
"Sensori di parcheggio anteriori",
"Telecamera per parcheggio assistito",
"Sensore di pioggia",
"Sensore di luce",
"Sensori di parcheggio posteriori",
"Specchietti laterali elettrici",
"Fari LED",
"Bracciolo",
"Volante in pelle",
"Adaptive Cruise Control",
"Luci diurne LED",
"Airbag testa",
"Sedile posteriore sdoppiato",
"Apple CarPlay",
"Android Auto"
]
},
"engine": {
"drivetrain": "front",
"gearbox": "manual",
"power": 110,
"gears": 6,
"cylinders": 4,
"capacity": 1968,
"netWeight": 1630,
"hp": 149
},
"environment": {
"fuel": "diesel",
"combinedConsumption": 4.7,
"combinedEmissions": 121,
"emissionClass": "6D"
},
"equipment": {},
"status": {
"category": "used",
"km": 27963,
"previousOwners": 0,
"registrationDate": "2021-02-03T00:00:00+00:00",
"damaged": false,
"documentedCheckup": false
}
}
L'oggetto listing
Attributi
id integer
Identificatore univoco per l'oggetto.
price integer
Prezzo del veicolo.
dealer object
Dati del concessionario.
headquarter object
Dati della sede.
address object
Indirizzo in cui si trova il veicolo.
status string
Stato di pubblicazione dell'annuncio: "draft" se è una bozza, "published" se è pubblicato, "hidden" se è stato eliminato.
title string
Titolo dell'annuncio.
vehicle object
Dati del veicolo.
{
"id": 1,
"photos": [
{
"id": 51,
"tag": "exterior_body_front_side_left",
"externalId": "http://graphics.gestionaleauto.com/gonline_graphics/18485947_O_63e1731571d0f.jpg",
"publicUrl": "https://cdn.autosupermarket.it/photos/prod/1/d7394c51d94714a770c1d79099ffabe1.jpg"
}
],
"brand": {
"id": 39,
"name": "Audi"
},
"model": {
"id": 6647,
"name": "35 TDI",
"brand": {
"id": 39,
"name": "Audi"
},
"parent": {
"id": 854,
"brand": {
"id": 39,
"name": "Audi"
},
"name": "Q3",
"slug": "audi/q3",
"cover": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/dev/upload-63fd1aab4f6d97.15348228.png"
}
}
},
"vehicle": {
"id": 1,
"detail": {
"body": "suv",
"seats": 5,
"doors": 5,
"externalType": "metallic",
"externalColor": "black",
"options": [
"ABS",
"Climatizzatore",
"Controllo automatico clima",
"Sistema di navigazione",
"Sedili riscaldati",
"Regolazione elettrica sedili",
"Alzacristalli elettrici",
"Airbag",
"Airbag Passeggero",
"Airbag laterali",
"Chiusura centralizzata",
"Immobilizzatore elettronico",
"Controllo trazione",
"Cerchi in lega",
"Boardcomputer",
"Servosterzo",
"Autoradio",
"ESP",
"Hill holder",
"Volante multifunzione",
"Bluetooth",
"Vivavoce",
"Isofix",
"USB",
"Start/Stop Automatico",
"Sensori di parcheggio anteriori",
"Telecamera per parcheggio assistito",
"Sensore di pioggia",
"Sensore di luce",
"Sensori di parcheggio posteriori",
"Specchietti laterali elettrici",
"Fari LED",
"Bracciolo",
"Volante in pelle",
"Adaptive Cruise Control",
"Luci diurne LED",
"Airbag testa",
"Sedile posteriore sdoppiato",
"Apple CarPlay",
"Android Auto"
]
},
"engine": {
"drivetrain": "front",
"gearbox": "manual",
"power": 110,
"gears": 6,
"cylinders": 4,
"capacity": 1968,
"netWeight": 1630,
"hp": 149
},
"environment": {
"fuel": "diesel",
"combinedConsumption": 4.7,
"combinedEmissions": 121,
"emissionClass": "6D"
},
"equipment": {},
"status": {
"category": "used",
"km": 27963,
"previousOwners": 0,
"registrationDate": "2021-02-03T00:00:00+00:00",
"damaged": false,
"documentedCheckup": false
},
"shownPhotos": [
{
"id": 51,
"tag": "exterior_body_front_side_left",
"externalId": "http://graphics.gestionaleauto.com/gonline_graphics/18485947_O_63e1731571d0f.jpg",
"publicUrl": "https://cdn.autosupermarket.it/photos/prod/1/d7394c51d94714a770c1d79099ffabe1.jpg"
}
]
},
"dealer": {
"id": 1,
"name": "AUTOHERO AUTOMOBILE.IT BRESCIA",
"logoFile": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/dev/upload-6400b48ea2f6d6.96515650.png"
},
"logo": "https://cdn.autosupermarket.it/uploads/dev/upload-6400b48ea2f6d6.96515650.png"
},
"externalId": "18485947",
"price": 42149,
"headquarter": {
"id": 1,
"name": "Sede",
"dealer": {
"id": 1,
"name": "AUTOHERO AUTOMOBILE.IT BRESCIA",
"logoFile": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/dev/upload-6400b48ea2f6d6.96515650.png"
},
"logo": "https://cdn.autosupermarket.it/uploads/dev/upload-6400b48ea2f6d6.96515650.png"
},
"address": {
"city": "BRESCIA",
"zipCode": "",
"province": "BS",
"address": "VIA",
"region": "Lombardia",
"country": "IT"
},
"email": "",
"telephone": {
"prefix":"+39",
"telephone": "191919"
},
"whatsapp": "191919",
"activeSubscription": {
"type": "free"
}
},
"status": "hidden",
"title": "SPB 35 TDI",
"publishDate": "2023-05-08T22:37:32+00:00",
"address": {
"coordinates": {
"latitude": 0,
"longitude": 0
},
"city": "BRESCIA",
"zipCode": "",
"province": "BS",
"address": "VIA",
"region": "Lombardia",
"country": "IT"
},
"protected": false,
"visible": true,
"pro": false,
"heading": "Audi Q3 35 TDI"
}
Lista annunci dell'headquarter
Recupera la lista degli annunci associati ad un headquarter specifico.
Query Parameters
page integer
Numero della pagina da visualizzare (default: 1)
perPage integer
Numero di elementi per pagina (default: 30)
Risposta
Restituisce un array di oggetti listing associati all'headquarter.
curl -X GET \
'https://api.autosupermarket.it/dealer/headquarters/246/listings?page=1&perPage=1' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: {your-token-here}'
Crea un annuncio
Inserisci un nuovo annuncio.
Parametri
vehicle object
Dati del veicolo.
price integer
Prezzo del veicolo.
dealer IRI
Identificativo del dealer.
headquarter IRI
Identificato dell'headquarter.
status string
Stato annuncio ("published", "draft" o "hidden").
title string
Titolo dell'annuncio.
description string
Descrizione dell'annuncio.
pro boolean
L'annuncio deve essere pro (è richiesta una subscription attiva).
Risposta
Ritorna l'oggetto listing se l'operazione è andata a buon fine.
curl -X POST \
'https://api.autosupermarket.it/listings' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: {your-token-here}' \
-d '{
"brand": "/listing/brands/39",
"model": "/listing/models/6607",
"vehicle": {
"detail": {
"body": "sedan",
"seats": 5,
"doors": 5,
"externalType": "metallic",
"externalColor": "gray",
"internalType": "fabric",
"internalColor": "black",
"options": [
"ABS",
"Volante riscaldato"
]
},
"engine": {
"drivetrain": "four_wheel",
"gearbox": "automatic",
"power": 331,
"gears": 8,
"cylinders": 6,
"capacity": 2900,
"netWeight": 5000,
"tank": 250
},
"environment": {
"fuel": "petrol",
"combinedConsumption": 0,
"combinedEmissions": 0,
"emissionClass": "E6"
},
"equipment": {},
"status": {
"category": "used",
"km": 25000,
"previousOwners": 1,
"previousOwnerIncludesDealers": true,
"registrationDate": "2020-06-21T13:48:03.494Z",
"damaged": true,
"documentedCheckup": true,
"previousOwnerSmoker": true,
"previousOwnerPets": true,
"previousOwnerPrivateGarage": true,
"previousOwnerKids": true,
"taxInformation": true,
"revisionInformation": true,
"taxExpiration": "2023-06-21T13:48:03.494Z",
"revisionDate": "2023-06-21T13:48:03.494Z",
"revisionKm": 0,
"taxAmount": 0,
"priceNegotiable": true,
"vatExposed": true,
"vatIncluded": true
},
"plate": "GB082CY",
"vin": "ASFDSADSADSAD"
},
"price": 75000,
"dealer": "/dealers/$dealerId",
"headquarter": "/dealer/headquarters/$headquarterId",
"status": "published",
"title": "Audi RS5",
"description": "La miglior AUDI sul mercato",
"pro": true
}'
{
"id": 230,
"photos": [],
"brand": {
"id": 39,
"name": "Audi"
},
"model": {
"id": 6607,
"name": "1.0",
"brand": {
"id": 39,
"name": "Audi"
},
"parent": {
"id": 852,
"brand": {
"id": 39,
"name": "Audi"
},
"name": "A1",
"slug": "audi/a1",
"cover": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/upload-63fd1aa77fd257.42874970.png"
}
}
},
"vehicle": {
"id": 230,
"detail": {
"body": "sedan",
"seats": 5,
"doors": 5,
"externalType": "metallic",
"externalColor": "gray",
"internalType": "fabric",
"internalColor": "black",
"options": [
"ABS",
"Volante riscaldato"
]
},
"engine": {
"drivetrain": "four_wheel",
"gearbox": "automatic",
"power": 331,
"gears": 8,
"cylinders": 6,
"capacity": 2900,
"netWeight": 5000,
"tank": 250,
"hp": 450
},
"environment": {
"fuel": "petrol",
"combinedConsumption": 0,
"combinedEmissions": 0,
"emissionClass": "E6"
},
"equipment": [],
"status": {
"category": "used",
"km": 25000,
"previousOwners": 1,
"previousOwnerIncludesDealers": true,
"registrationDate": "2020-06-21T13:48:03+00:00",
"damaged": true,
"documentedCheckup": true,
"previousOwnerSmoker": true,
"previousOwnerPets": true,
"previousOwnerPrivateGarage": true,
"previousOwnerKids": true,
"taxInformation": true,
"revisionInformation": true,
"taxExpiration": "2023-06-21T13:48:03+00:00",
"revisionDate": "2023-06-21T13:48:03+00:00",
"revisionKm": 0,
"taxAmount": 0,
"priceNegotiable": true,
"vatExposed": true,
"vatIncluded": true
},
"shownPhotos": []
},
"dealer": {
"id": 102,
"name": "test",
"logoFile": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/"
},
"logo": "/media/images/search/default-listing-index.png"
},
"price": 75000,
"headquarter": {
"id": 100,
"name": "Test",
"dealer": {
"id": 102,
"name": "test",
"logoFile": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/"
},
"logo": "/media/images/search/default-listing-index.png"
},
"address": {
"coordinates": {
"latitude": 0,
"longitude": 0
},
"city": "Brescia",
"zipCode": "25132",
"province": "BS",
"address": "Via Valcamonica",
"region": "Lombardia",
"country": "IT"
},
"telephone": {
"prefix": "39",
"telephone": "0305543434"
},
"activeSubscription": {
"type": "free"
}
},
"status": "published",
"title": "Audi RS5",
"address": {
"coordinates": {
"latitude": 0,
"longitude": 0
},
"city": "Brescia",
"zipCode": "25132",
"province": "BS",
"address": "Via Valcamonica",
"region": "Lombardia",
"country": "IT"
},
"protected": false,
"visible": true,
"pro": false,
"heading": "Audi A1 1.0"
}
Crea un annuncio tramite infocar
Questa chiamata permette di identificare il valore dei campi da passare alla chiamata di creazione di annuncio se si ha a disposizione il codice infocar di una veicolo.
Parametri
infocar required string
Codice infocar.
Risposta
Ritorna l'oggetto parziali listing se è stata generata la corrispondenza o 404 se non è riuscito a identificare l'esatta corrispondenza.
curl -X POST \
'https://api.autosupermarket.it/listings/initialize-from-infocar' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: {your-token-here}' \
-d '{
"infocar": "107746201906"
}'
{
"vehicle": {
"detail": {
"body": "sedan",
"seats": 4,
"doors": 3
},
"engine": {
"drivetrain": "front",
"gearbox": "manual",
"power": 170,
"gears": 6,
"cylinders": 4,
"capacity": 1998,
"netWeight": 1310,
"tank": 44
},
"environment": {
"fuel": "petrol",
"combinedConsumption": 9.2,
"combinedEmissions": 0
}
},
"brand": "/listing/brands/22",
"model": "/listing/models/2714",
"infocarCode": "201906107746"
}
Ottieni l'annuncio
Recupera i dettagli di una listing esistente.
Parametri
Nessun paramentro.
Risposta
Restituisce un oggetto listing se è stato fornito un identificatore valido e restituisce un errore in caso contrario.
curl -X GET \
'https://api.autosupermarket.it/listings/:id' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: {your-token-here}'
{
"id": 230,
"photos": [],
"brand": {
"id": 39,
"name": "Audi"
},
"model": {
"id": 6607,
"name": "1.0",
"brand": {
"id": 39,
"name": "Audi"
},
"parent": {
"id": 852,
"brand": {
"id": 39,
"name": "Audi"
},
"name": "A1",
"slug": "audi/a1",
"cover": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/upload-63fd1aa77fd257.42874970.png"
}
}
},
"vehicle": {
"id": 230,
"detail": {
"body": "sedan",
"seats": 5,
"doors": 5,
"externalType": "metallic",
"externalColor": "gray",
"internalType": "fabric",
"internalColor": "black",
"options": [
"ABS",
"Volante riscaldato"
]
},
"engine": {
"drivetrain": "four_wheel",
"gearbox": "automatic",
"power": 331,
"gears": 8,
"cylinders": 6,
"capacity": 2900,
"netWeight": 5000,
"tank": 250,
"hp": 450
},
"environment": {
"fuel": "petrol",
"combinedConsumption": 0,
"combinedEmissions": 0,
"emissionClass": "E6"
},
"equipment": [],
"status": {
"category": "used",
"km": 25000,
"previousOwners": 1,
"previousOwnerIncludesDealers": true,
"registrationDate": "2020-06-21T13:48:03+00:00",
"damaged": true,
"documentedCheckup": true,
"previousOwnerSmoker": true,
"previousOwnerPets": true,
"previousOwnerPrivateGarage": true,
"previousOwnerKids": true,
"taxInformation": true,
"revisionInformation": true,
"taxExpiration": "2023-06-21T13:48:03+00:00",
"revisionDate": "2023-06-21T13:48:03+00:00",
"revisionKm": 0,
"taxAmount": 0,
"priceNegotiable": true,
"vatExposed": true,
"vatIncluded": true
},
"shownPhotos": []
},
"dealer": {
"id": 102,
"name": "test",
"logoFile": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/"
},
"logo": "/media/images/search/default-listing-index.png"
},
"price": 75000,
"headquarter": {
"id": 100,
"name": "Test",
"dealer": {
"id": 102,
"name": "test",
"logoFile": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/"
},
"logo": "/media/images/search/default-listing-index.png"
},
"address": {
"coordinates": {
"latitude": 0,
"longitude": 0
},
"city": "Brescia",
"zipCode": "25132",
"province": "BS",
"address": "Via Valcamonica",
"region": "Lombardia",
"country": "IT"
},
"telephone": {
"prefix": "39",
"telephone": "0305543434"
},
"activeSubscription": {
"type": "free"
}
},
"status": "published",
"title": "Audi RS5",
"address": {
"coordinates": {
"latitude": 0,
"longitude": 0
},
"city": "Brescia",
"zipCode": "25132",
"province": "BS",
"address": "Via Valcamonica",
"region": "Lombardia",
"country": "IT"
},
"protected": false,
"visible": true,
"pro": false,
"heading": "Audi A1 1.0"
}
Aggiorna l'annuncio
Aggiorna l'annuncio specificato impostando i valori dei parametri passati. Eventuali parametri non forniti verranno lasciati invariati.
Parametri
vehicle object
Dati del veicolo.
price integer
Prezzo del veicolo.
dealer IRI
Identificativo del dealer.
headquarter IRI
Identificato dell'headquarter.
status string
Stato annuncio ("published", "draft" o "hidden").
title string
Titolo dell'annuncio.
description string
Descrizione dell'annuncio.
pro boolean
L'annuncio deve essere pro (è richiesta una subscription attiva).
Risposta
Restituisce un oggetto listing aggiornato se l'aggiornamento è andato a buon fine.
curl -X PATCH \
'https://api.autosupermarket.it/listings/:id' \
-H 'Content-Type: application/merge-patch+json' \
-H 'X-Auth-Token: {your-token-here}' \
-d '{
"status": "draft"
}'
{
"id": 230,
"photos": [],
"brand": {
"id": 39,
"name": "Audi"
},
"model": {
"id": 6607,
"name": "1.0",
"brand": {
"id": 39,
"name": "Audi"
},
"parent": {
"id": 852,
"brand": {
"id": 39,
"name": "Audi"
},
"name": "A1",
"slug": "audi/a1",
"cover": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/upload-63fd1aa77fd257.42874970.png"
}
}
},
"vehicle": {
"id": 230,
"detail": {
"body": "sedan",
"seats": 5,
"doors": 5,
"externalType": "metallic",
"externalColor": "gray",
"internalType": "fabric",
"internalColor": "black",
"options": [
"ABS",
"Volante riscaldato"
]
},
"engine": {
"drivetrain": "four_wheel",
"gearbox": "automatic",
"power": 331,
"gears": 8,
"cylinders": 6,
"capacity": 2900,
"netWeight": 5000,
"tank": 250,
"hp": 450
},
"environment": {
"fuel": "petrol",
"combinedConsumption": 0,
"combinedEmissions": 0,
"emissionClass": "E6"
},
"equipment": [],
"status": {
"category": "used",
"km": 25000,
"previousOwners": 1,
"previousOwnerIncludesDealers": true,
"registrationDate": "2020-06-21T13:48:03+00:00",
"damaged": true,
"documentedCheckup": true,
"previousOwnerSmoker": true,
"previousOwnerPets": true,
"previousOwnerPrivateGarage": true,
"previousOwnerKids": true,
"taxInformation": true,
"revisionInformation": true,
"taxExpiration": "2023-06-21T13:48:03+00:00",
"revisionDate": "2023-06-21T13:48:03+00:00",
"revisionKm": 0,
"taxAmount": 0,
"priceNegotiable": true,
"vatExposed": true,
"vatIncluded": true
},
"shownPhotos": []
},
"dealer": {
"id": 102,
"name": "test",
"logoFile": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/"
},
"logo": "/media/images/search/default-listing-index.png"
},
"price": 75000,
"headquarter": {
"id": 100,
"name": "Test",
"dealer": {
"id": 102,
"name": "test",
"logoFile": {
"publicUrl": "https://cdn.autosupermarket.it/uploads/test/"
},
"logo": "/media/images/search/default-listing-index.png"
},
"address": {
"coordinates": {
"latitude": 0,
"longitude": 0
},
"city": "Brescia",
"zipCode": "25132",
"province": "BS",
"address": "Via Valcamonica",
"region": "Lombardia",
"country": "IT"
},
"telephone": {
"prefix": "39",
},
"activeSubscription": {
"type": "free"
}
},
"status": "published",
"title": "Audi RS5",
"address": {
"coordinates": {
"latitude": 0,
"longitude": 0
},
"city": "Brescia",
"zipCode": "25132",
"province": "BS",
"address": "Via Valcamonica",
"region": "Lombardia",
"country": "IT"
},
"protected": false,
"visible": true,
"pro": false,
"heading": "Audi A1 1.0"
}
Elimina l'annuncio
Elimina un listing. L'annuncio viene nascosto immediatamente, l'eliminazione potrebbe essere eseguita in un secondo momento.
Parametri
Nessun paramentro.
Risposta
Restituisce codice HTTP 200 se l'aggiornamento è andato a buon fine, altrimenti ritorna un errore.
curl -X DELETE \
'https://api.autosupermarket.it/listings/:id' \
-H 'X-Auth-Token: {your-token-here}'