Dealer

Il dealer rappresenta il "gruppo" sotto il quale sono racchiuse le diverse sedi di una concessionaria. Ogni account venditore, anche se il gruppo ha una sola sede, ha un oggetto Dealer legato all'utente. Il Dealer, insieme all'oggetto sede, vengono utilizzati per tutte le operazioni API sui veicoli. Assicurati quindi di avere sempre l'ID del Dealer per fare chiamate API di caricamento o di modifica di un annuncio.

Endpoints

L'oggetto dealer

Attributi

id integer

Identificatore univoco per l'oggetto.

name string

Nome del concessionario.

logoFile object

Percorso URL del logo identificativo del concessionario.

L'oggetto Dealer
{
    "id": 1,
    "name": "AutoSuperMarket s.r.l.",
    "logoFile": {
        "publicUrl": "https://cdn.autosupermarket.it/uploads/dev/"
    }
}

Ottieni il dealer

Recupera i dettagli di un dealer esistente. Fornisci l'ID del dealer univoco legato al tuo utente da una richiesta di autenticazione e AutoSuperMarket restituirà le informazioni corrispondenti.

Parametri

Nessun paramentro.

Risposta

Restituisce un oggetto dealer se è stato fornito un identificatore valido e restituisce un errore in caso contrario.

GET /dealers/:id
curl -X GET \
'https://api.autosupermarket.it/dealers/:id' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: {your-token-here}'
Risposta
{
    "id": 1,
    "name": "AutoSuperMarket s.r.l.",
    "logoFile": {
        "publicUrl": "https://cdn.autosupermarket.it/uploads/dev/"
    }
}

Aggiorna il dealer

Aggiorna il dealer specificato impostando i valori dei parametri passati. Eventuali parametri non forniti verranno lasciati invariati.

Parametri

name string

Nome del concessionario.

Risposta

Restituisce un oggetto dealer aggiornato se l'aggiornamento è andato a buon fine.

PATCH /dealers/:id
curl -X PATCH \
'https://api.autosupermarket.it/dealers/:id' \
-H 'Content-Type: application/merge-patch+json' \
-H 'X-Auth-Token: {your-token-here}'
-d '{"name": "Nuovo nome del concessionario"}'
Risposta
{
    "id": 1,
    "name": "Nuovo nome del concessionario",
    "logoFile":{
        "publicUrl": "https://cdn.autosupermarket.it/uploads/prod/upload-218938219-329183291.png"
    }
}