404 lines
14 KiB
Plaintext
404 lines
14 KiB
Plaintext
Guida utilizzo Motornet:
|
||
|
||
Definizione dei servizi
|
||
Le definizione dei servizi Motornet sono disponibili all'url https://webservice.motornet.it/api/ sia per l'interfaccia REST che per l'interfaccia SOAP, nella sezione "Versione 3".
|
||
|
||
Le strutture dati utilizzate sono comuni tra REST e SOAP e definite in schemi XSD disponibili all'url https://webservice.motornet.it/api/services/v3_0/xsd
|
||
|
||
I web services sono raggruppati per mercato (nuovo/usato) e per tipo veicolo.
|
||
|
||
Autenticazione
|
||
L'accesso all'infrastruttura Motornet è governata da un server OAuth2 standard. La definizione publica del servizio è raggiungibile all’url https://webservice.motornet.it/auth/realms/webservices/.well-known/openid-configuration
|
||
|
||
Tutte le chiamate ai web services Motornet devono includere l’header di autenticazione standard OAuth 2.0 Bearer Token [https://datatracker.ietf.org/doc/html/rfc6750]
|
||
|
||
L’Access token si ottiene dal server OAuth2 Motornet; segue un esempio a riga di comando (linux) [sostituire USERNAME & PASSWORD con quelle a voi assegnate]
|
||
|
||
curl --data "grant_type=password&client_id=webservice&username=USERNAME&password=PASSWORD" https://webservice.motornet.it/auth/realms/webservices/protocol/openid-connect/token
|
||
Si noti che, come da specifiche OAuth2, è necessario effettuare il refresh periodico dell’access token [Sostituire REFRESH_TOKEN con il corrispondente valore ricevuto nella chiamata sopra]
|
||
|
||
curl --data "grant_type=refresh_token&client_id=webservice&refresh_token=REFRESH_TOKEN" https://webservice.motornet.it/auth/realms/webservices/protocol/openid-connect/token
|
||
|
||
|
||
|
||
|
||
Path per verifica targa
|
||
/public/usato/generali/targa
|
||
|
||
Chiamata:
|
||
curl -X GET -H "Authorization: bearer TOKEN" "https://webservice.motornet.it/api/v3_0/rest/public/usato/generali/targa?targa=fd360rb"
|
||
|
||
Risposta:
|
||
<xs:complexType name="SearchTargaResultJs">
|
||
<xs:complexContent>
|
||
<xs:extension base="gsh:SearchTargaResultBase">
|
||
<xs:sequence>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="versioni" tipo="sh:VeicoloBase"/>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="marche" tipo="sh:Marca"/>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="modelli" tipo="sh:Modello"/>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="gamme" tipo="sh:Gamma"/>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="porte" tipo="xs:int"/>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="passi" tipo="xs:decimal"/>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="tipologie" tipo="sh:CodiceDescrizione"/>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="gruppi" tipo="sh:Gruppo"/>
|
||
</xs:sequence>
|
||
</xs:extension>
|
||
</xs:complexContent>
|
||
</xs:complexType>
|
||
|
||
|
||
|
||
Valutazione:
|
||
|
||
valutazione
|
||
Ultima modifica di Mauro Cerutti il 2022/09/07 17:20
|
||
Path
|
||
/public/usato/auto/valutazione
|
||
|
||
Descrizione
|
||
Valutazione di un determinato veicolo
|
||
|
||
Parametri
|
||
parametro codiceMotornetUnivoco
|
||
stile query
|
||
obbligatorio si
|
||
formato stringa
|
||
descrizione Codice Mnet (Codice Motornet univoco)
|
||
parametro anno
|
||
stile template
|
||
obbligatorio si
|
||
formato numero (AAAA)
|
||
descrizione anno di immatricolazione del veicolo
|
||
parametro mese
|
||
stile query
|
||
obbligatorio si
|
||
formato intero [1-12]
|
||
descrizione mese di immatricolazione del veicolo
|
||
parametro km
|
||
stile query
|
||
obbligatorio no
|
||
formato intero
|
||
descrizione km percorsi dal veicolo
|
||
parametro codice_omologazione
|
||
stile query
|
||
obbligatorio no
|
||
formato string
|
||
descrizione codice di omologazione del veicolo
|
||
parametro targa
|
||
stile query
|
||
obbligatorio no
|
||
formato stringa
|
||
descrizione targa del veicolo
|
||
parametro telaio
|
||
stile query
|
||
obbligatorio no
|
||
formato string
|
||
descrizione numero telaio del veicolo
|
||
parametro CostoOrarioManodoperaMeccanica
|
||
stile query
|
||
obbligatorio no
|
||
formato decimale
|
||
descrizione costo manodopera dell'eventuale riparazione meccanica
|
||
parametro CostoOrarioManodoperaCarrozzeria
|
||
stile query
|
||
obbligatorio no
|
||
formato decimal
|
||
descrizione costo manodopera dell'eventuale riparazione della carrozzeria
|
||
parametro autocarro
|
||
stile query
|
||
obbligatorio no
|
||
formato boolean
|
||
descrizione SOLO PER AUTO - flag per correggere la valutazione per i veicoli immatricolati come autocarro (true = sì, false = no)
|
||
parametro neoPatentato
|
||
stile query
|
||
obbligatorio no
|
||
formato boolean
|
||
descrizione se valorizzato in input, viene restituito in output e nell'XML
|
||
parametro ValutazioneDealer
|
||
stile query
|
||
obbligatorio no
|
||
formato decimal
|
||
descrizione Valutazione inserita dal Dealer
|
||
parametro annoValutazione
|
||
stile query
|
||
obbligatorio no
|
||
formato integer
|
||
descrizione anno della pubblicazione da utilizzare per la valutazione
|
||
parametro meseValutazione
|
||
stile query
|
||
obbligatorio no
|
||
formato intero [1-12]
|
||
descrizione mese della pubblicazione da utilizzare per la valutazione
|
||
parametro guidkey
|
||
stile query
|
||
obbligatorio no
|
||
formato string
|
||
descrizione codice univoco da generare lato client per poter recuperare, in un secondo momento, l’xml della valutazione
|
||
parametro perizia
|
||
stile query
|
||
obbligatorio no
|
||
formato periziaValutazione
|
||
descrizione valutazione della perizia effettuata
|
||
parametro accessori
|
||
stile query
|
||
obbligatorio no
|
||
formato shu:AccessorioValutazioneRequest
|
||
descrizione indicare gli accessori opzionali (ID, prezzo) da inserire nella valutazione
|
||
parametro lavoriMeccanica
|
||
stile query
|
||
obbligatorio no
|
||
formato shu:Riparazione
|
||
descrizione indicare il nome, le ore ed il prezzo delle riparazioni meccaniche da inserire nella valutazione
|
||
parametro lavoriCarrozzeria
|
||
stile query
|
||
obbligatorio no
|
||
formato shu:Riparazione
|
||
descrizione indicare l'ID dell'accessorio
|
||
Risposta
|
||
tipo shu:ValutazioneJs
|
||
mime application/json
|
||
<xs:complexType name="ValutazioneJs">
|
||
<xs:complexContent>
|
||
<xs:extension base="shu:AbstractValutazione">
|
||
<xs:sequence>
|
||
<xs:element name="id" tipo="xs:integer"></xs:element>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="accessoriSerie" tipo="shu:AccessorioValutazione"></xs:element>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="accessoriOptional" tipo="shu:AccessorioValutazione"></xs:element>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="riparazioniCarrozzeria" tipo="shu:Riparazione"></xs:element>
|
||
<xs:element minOccurs="0" maxOccurs="unbounded" name="riparazioniMeccanica" tipo="shu:Riparazione"></xs:element>
|
||
</xs:sequence>
|
||
</xs:extension>
|
||
</xs:complexContent>
|
||
</xs:complexType>
|
||
Esempio
|
||
|
||
curl -X POST -H "Content-Type: application/json" -H "Authorization: bearer TOKEN" "https://webservice.motornet.it/api/v3_0/rest/public/usato/auto/valutazione" --data '{"codiceMotornetUnivoco":"A084507","anno":2019,"mese":10,"km":1000,"targa":null,"telaio":null,"accessori":[{"id":15065288,"prezzo":350}],"codiceOmologazione":123,"costoOrarioManodoperaMeccanica":35,"costoOrarioManodoperaCarrozzeria":50,"autocarro":false,"lavoriMeccanica":[{"nome":"aaaa","ore":1,"prezzo":100},{"nome":"bbbb","ore":1,"prezzo":100}],"lavoriCarrozzeria":[{"nome":"aaaa","ore":1,"prezzo":100},{"nome":"bbbb","ore":1,"prezzo":100}],"valutazioneDealer":1000,"annoValutazione":null,"meseValutazione":null,"guidkey":"PROVALUCAUI1"}'
|
||
{
|
||
"valutazione": {
|
||
"edizDati": "09/2022",
|
||
"marca": {
|
||
"acronimo": "MER",
|
||
"nome": "Mercedes"
|
||
},
|
||
"allestimento": "E 200 d Exclusive auto",
|
||
"anno": 2019,
|
||
"mese": 10,
|
||
"km": 1000,
|
||
"targa": null,
|
||
"quotazioneEurotaxBlu": 21500.00,
|
||
"quotazioneEurotaxBluKm": 24500.00,
|
||
"quotazioneEurotaxGiallo": 25000.00,
|
||
"quotazioneEurotaxGialloKm": 28000.00,
|
||
"descrizionePeriodoValutazione": "09/2022",
|
||
"tipoVeicolo": null,
|
||
"codiceOmologazione": "123",
|
||
"telaio": null,
|
||
"modello": "Classe E - W213 Berlina",
|
||
"autocarro": false,
|
||
"immagine": "https://www.motornet.it/img/modelli/auto/MER/Classe%20E%201.jpg",
|
||
"codiceMotornetUnivoco": "A084507",
|
||
"codiceMotore": "654916",
|
||
"alimentazione": {
|
||
"codice": "D",
|
||
"descrizione": "Diesel"
|
||
},
|
||
"quotazioneEurotaxBluTotale": 26321.2000,
|
||
"quotazioneEurotaxGialloTotale": 29821.2000,
|
||
"ivaBlu": null,
|
||
"ivaGiallo": null,
|
||
"variazioneKm": 3000.00,
|
||
"variazionePersonalizzata": null,
|
||
"valutazioneDealer": 1000,
|
||
"percorrenzaMediaKm": 70000,
|
||
"dataImmatricolazione": null,
|
||
"dataImmatricolazioneEstero": null,
|
||
"dataImmatricolazioneItalia": null,
|
||
"paeseImmatricolazioneEstero": null,
|
||
"targaEstero": null,
|
||
"dataUltimaRevisione": null,
|
||
"prezzoAccessori": 2391.2000,
|
||
"prezzoListino": 58115.00,
|
||
"totaleRiparazioniCarrozzeria": 300.0000,
|
||
"costoOrarioManodoperaCarrozzeria": 50,
|
||
"totaleRiparazioniMeccanica": 270.0000,
|
||
"costoOrarioManodoperaMeccanica": 35,
|
||
"xml": "https://webservice.motornet.it/xml/2022/09/07/mauro_80120_20220907_171236.xml",
|
||
"perizia": null,
|
||
"id": 21661063,
|
||
"accessoriSerie": [
|
||
{
|
||
"id": 15065082,
|
||
"uff": {
|
||
"codice": "580",
|
||
"descrizione": "Climatizzatore automatico THERMATIC"
|
||
},
|
||
"norm": {
|
||
"codice": "0017",
|
||
"descrizione": "Climatizzatore automatico"
|
||
},
|
||
"mot": null,
|
||
"gruppo": {
|
||
"codice": "S",
|
||
"descrizione": "Di Serie"
|
||
},
|
||
"idDizionario": 70603,
|
||
"prezzo": null,
|
||
"prezzoListino": null,
|
||
"dataListino": "2019-10-22",
|
||
"macroGruppo": {
|
||
"codice": "0020",
|
||
"descrizione": "Abitacolo interno"
|
||
}
|
||
},
|
||
{
|
||
"id": 15065088,
|
||
"uff": {
|
||
"codice": "891",
|
||
"descrizione": "Luci «ambient» 64 colori e tre zone cromatiche"
|
||
},
|
||
"norm": {
|
||
"codice": "0136",
|
||
"descrizione": "Illuminazione abitacolo"
|
||
},
|
||
"mot": null,
|
||
"gruppo": {
|
||
"codice": "S",
|
||
"descrizione": "Di Serie"
|
||
},
|
||
"idDizionario": 207422,
|
||
"prezzo": null,
|
||
"prezzoListino": null,
|
||
"dataListino": "2019-10-22",
|
||
"macroGruppo": {
|
||
"codice": "0020",
|
||
"descrizione": "Abitacolo interno"
|
||
}
|
||
},
|
||
{
|
||
"id": 15065151,
|
||
"uff": {
|
||
"codice": "U25",
|
||
"descrizione": "Soglie d'ingresso anteriori illuminate"
|
||
},
|
||
"norm": {
|
||
"codice": "0136",
|
||
"descrizione": "Illuminazione abitacolo"
|
||
},
|
||
"mot": null,
|
||
"gruppo": {
|
||
"codice": "S",
|
||
"descrizione": "Di Serie"
|
||
},
|
||
"idDizionario": 71590,
|
||
"prezzo": 0.00,
|
||
"prezzoListino": 0.00,
|
||
"dataListino": "2019-10-22",
|
||
"macroGruppo": {
|
||
"codice": "0020",
|
||
"descrizione": "Abitacolo interno"
|
||
}
|
||
},
|
||
{
|
||
"id": 15065147,
|
||
"uff": {
|
||
"codice": "246",
|
||
"descrizione": "Orologio analogico nella consolle centrale"
|
||
},
|
||
"norm": {
|
||
"codice": "0156",
|
||
"descrizione": "Orologio analogico"
|
||
},
|
||
"mot": null,
|
||
"gruppo": {
|
||
"codice": "S",
|
||
"descrizione": "Di Serie"
|
||
},
|
||
"idDizionario": 71194,
|
||
"prezzo": 0.00,
|
||
"prezzoListino": 0.00,
|
||
"dataListino": "2019-10-22",
|
||
"macroGruppo": {
|
||
"codice": "0020",
|
||
"descrizione": "Abitacolo interno"
|
||
}
|
||
},
|
||
...
|
||
{
|
||
"id": 15065083,
|
||
"uff": {
|
||
"codice": "B59",
|
||
"descrizione": "Dynamic Select"
|
||
},
|
||
"norm": {
|
||
"codice": "0187",
|
||
"descrizione": "Selettore stile di guida"
|
||
},
|
||
"mot": null,
|
||
"gruppo": {
|
||
"codice": "S",
|
||
"descrizione": "Di Serie"
|
||
},
|
||
"idDizionario": 81091,
|
||
"prezzo": 0.00,
|
||
"prezzoListino": 0.00,
|
||
"dataListino": "2019-10-22",
|
||
"macroGruppo": {
|
||
"codice": "0009",
|
||
"descrizione": "Sistemi di assistenza"
|
||
}
|
||
}
|
||
],
|
||
"accessoriOptional": [
|
||
{
|
||
"id": 15065288,
|
||
"uff": {
|
||
"codice": "P62",
|
||
"descrizione": "Interni in nero / grigio titanio pearl designo"
|
||
},
|
||
"norm": {
|
||
"codice": "0109",
|
||
"descrizione": "Interni personalizzazione colori"
|
||
},
|
||
"mot": null,
|
||
"gruppo": {
|
||
"codice": "O",
|
||
"descrizione": "Optional"
|
||
},
|
||
"idDizionario": 905147,
|
||
"prezzo": 350,
|
||
"prezzoListino": 5978.00,
|
||
"dataListino": "2019-10-22",
|
||
"macroGruppo": {
|
||
"codice": "0001",
|
||
"descrizione": "Interni"
|
||
}
|
||
}
|
||
],
|
||
"riparazioniCarrozzeria": [
|
||
{
|
||
"nome": "aaaa",
|
||
"ore": 1.00,
|
||
"prezzo": 100.00
|
||
},
|
||
{
|
||
"nome": "bbbb",
|
||
"ore": 1.00,
|
||
"prezzo": 100.00
|
||
}
|
||
],
|
||
"riparazioniMeccanica": [
|
||
{
|
||
"nome": "aaaa",
|
||
"ore": 1.00,
|
||
"prezzo": 100.00
|
||
},
|
||
{
|
||
"nome": "bbbb",
|
||
"ore": 1.00,
|
||
"prezzo": 100.00
|
||
}
|
||
]
|
||
},
|
||
"valutazioniDisponibili": 8929,
|
||
"accessiDisponibili": 998449
|
||
} |