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}
'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}'