Servizi
Il campo services indica le informazioni che InfoTarga deve cercare per il veicolo.
Deve essere un array non vuoto, non può contenere duplicati e accetta esclusivamente i valori documentati in questa pagina.
Ogni servizio richiesto compare nella proprietà services della risposta con il relativo esito.
Servizi disponibili
| Servizio | Descrizione | Piano |
|---|---|---|
details | Informazioni identificative e tecniche del veicolo, come marca, modello, allestimento, immatricolazione, alimentazione, potenza e cilindrata. | Tutti |
insurance | Stato assicurativo del veicolo ed eventuali informazioni sulla compagnia, sulla polizza e sulla copertura. | Tutti |
emissions | Classe ambientale del veicolo. | Tutti |
license | Idoneità del veicolo alla guida da parte di un neopatentato. | Tutti |
inspection | Stato della revisione, scadenze calcolate e storico delle revisioni disponibili. | Pro / Ultra |
theft | Presenza o assenza di una denuncia di furto associata al veicolo. | Pro / Ultra |
La disponibilità di un servizio può dipendere dalla tipologia e dalla situazione del veicolo. Richiedere un servizio non garantisce che ogni possibile informazione sia disponibile.
Esito dei servizi
La proprietà services della risposta contiene l'esito finale di ciascun servizio richiesto.
Gli esiti possibili sono:
| Esito | Significato |
|---|---|
completed | Il servizio ha raggiunto una conclusione valida. Anche una risposta negativa esplicita, come l'assenza di una copertura assicurativa o di una denuncia di furto, è considerata completata. |
partial | Sono state ottenute informazioni utili, ma il servizio non ha raggiunto una conclusione completa. |
empty | Il servizio è stato eseguito correttamente, ma non ha prodotto informazioni utilizzabili o applicabili. |
failed | Il tentativo non è riuscito a causa di un errore temporaneo e può essere ripetuto. |
unavailable | Il servizio è supportato, ma non è stato possibile eseguirlo nelle circostanze correnti. |
unsupported | Il servizio non è applicabile al veicolo o al caso richiesto. |
L'esito non deve essere interpretato osservando soltanto la presenza o l'assenza dei singoli campi. Per esempio, insurance: "completed" può accompagnare hasInsurance: false: in questo caso il servizio ha concluso correttamente che il veicolo non risulta assicurato.
Servizi non inclusi nel piano
I servizi inspection e theft sono disponibili con i piani Pro e superiori.
Se uno di questi servizi viene richiesto con un piano che non lo include, rimane presente nella risposta con esito unavailable. Gli altri servizi richiesti continuano a essere eseguiti normalmente.