Photo
L'oggetto Photo rappresenta la foto di un veicolo, facente parte del database di AutoSuperMarket.
L'oggetto photo
Attributi
id integer
Identificatore univoco per la foto del veicolo.
tag string
Identificativo string della foto del veicolo.
externalId string
Identificativo esterno della foto.
publicUrl string
Indirizzo url pubblico della foto.
{
"id": 1,
"tag": "exterior_body_front_side_right",
"externalId": "http://autosupermarket.it/18408241_O_63e462b7db050.jpg",
"publicUrl": "https://cdn.autosupermarket.it/photos/prod/35/eac2dfb24a5c8fd3d822cc635fe41e05.jpg"
}Aggiungi un nuovo listing/photo
Aggiungi una nuova foto di un veicolo.
Parametri
listing required integer
ID del veicolo per il quale si intende aggiungere una nuova foto.
file object
File della foto che si vuole inserire.
identifier string
Identificativo della foto.
position integer
Ordinamento foto.
Risposta
Ritorna l'oggetto photo se l'operazione è andata a buon fine.
curl -X 'POST' \
'https://api.autosupermarket.wip/listings/listing/photos' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-F 'file={your-file-here}' \
-F 'identifier={your-identifier-here}' \
-F 'position={your-position-here}' \
-H 'X-Auth-Token: {your-token-here}
'Aggiungi un nuovo listing/photo tramite URL
Aggiungi una nuova foto di un veicolo fornendo l'URL pubblico dell'immagine. AutoSuperMarket scaricherà il contenuto dall'URL indicato e lo elaborerà. Utile quando le foto sono già ospitate su un server esterno e non si vuole effettuare l'upload diretto del file.
Se sul veicolo esiste già una foto con lo stesso URL (campo externalId),
questa viene sostituita con la nuova.
Parametri
listing required integer
ID del veicolo per il quale si intende aggiungere una nuova foto.
url required string
URL pubblico dell'immagine da scaricare ed associare al veicolo.
position required integer
Ordinamento foto.
Risposta
Ritorna codice HTTP 202 e l'oggetto photo se l'operazione è andata a buon fine. L'elaborazione dell'immagine avviene in modo asincrono. In caso di URL non raggiungibile viene restituito un errore.
curl -X 'POST' \
'https://api.autosupermarket.it/listings/:listing/photos/by-url' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: {your-token-here}' \
-d '{
"url": "https://example.com/foto-veicolo.jpg",
"position": 0
}'{
"id": 1,
"tag": "exterior_body_front_side_right",
"externalId": "https://example.com/foto-veicolo.jpg",
"publicUrl": "https://cdn.autosupermarket.it/photos/prod/35/eac2dfb24a5c8fd3d822cc635fe41e05.jpg"
}Ottieni la foto
Recupera i dettagli di una foto esistente. Fornisci l'ID univoco del veicolo e della foto ed AutoSuperMarket restituirà le informazioni corrispondenti.
Parametri
listing required integer
ID del veicolo per il quale si intende aggiungere una nuova foto.
id required integer
ID della foto che si vuole cercare.
Risposta
Restituisce un oggetto photo se sono stati forniti gli identificatori validi e restituisce un errore in caso contrario.
curl -X GET \
'https://api.autosupermarket.it/listing/:listing/photos/:id' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: {your-token-here}'{
"id": 1,
"tag": "exterior_body_front_side_right",
"externalId": "http://autosupermarket.it/18408241_O_63e462b7db050.jpg",
"publicUrl": "https://cdn.autosupermarket.it/photos/prod/35/eac2dfb24a5c8fd3d822cc635fe41e05.jpg"
}Elimina la foto
Elimina una foto. L'eliminazione di una foto è possibile solo se non ci sono annunci associati attualmente pubblicati.
Parametri
listing required integer
ID del veicolo per il quale si intende eliminare una nuova foto.
id required integer
ID della foto che si vuole eliminare.
Risposta
Restituisce codice HTTP 200 se l'aggiornamento è andato a buon fine, altrimenti ritorna un errore.
curl -X DELETE \
'https://api.autosupermarket.it/listing/:listing/photos/:id' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: {your-token-here}'