Questa documentazione web consente ai Partner Infodrive di interfacciare i propri sistemi con i Servizi Infodrive. Tutte le chiamate dettagliate in questa documentazione web sono protette da Autenticazione OAuth 2.0. Se non sei in possesso delle credenziali necessarie all'utilizzo di queste API, contatta l'Assistenza Tecnica inviando una mail a informatica@infodrive.it.
Utilizza il menu di navigazione per spostarti tra le varie sezioni della documentazione web.
Per accedere ai Servizi API Infodrive è necessario effettuare l'autenticazione prima di ogni chiamata. Il sistema di autenticazione utilizzato è il OAuth 2.0 .
A seguito dell'attivazione dei servizi a voi dedicati vi verranno fornite delle Credenziali di Autenticazione API (Client Credentials) composte come di seguito:
Queste credenziali sono necessarie alla generazione del Token di Autenticazione (Bearer Token) da impostare negli header di ogni chiamata da effettuare.
La distinzione tra ambiente di produzione ed ambiente di test è dato dal set di Client Credentials utilizzate per richiedere il Token di Autenticazione.
Consente di richiedere un token. Il token è valido per 60 secondi dalla generazione, scaduti i quali andrà rigenerato con una nuova richiesta. In caso di successo la risposta include anche id_utente, corrispondente all'utente Infodrive associato alle Client Credentials.
https://servizi.infodrive.it/oauth/request/
Elenco di tutti i prodotti presenti a listino, con relativi prezzi. Le card hanno type: "card". I SAT hanno type: "sat" e cod = valore da passare a sat.Insert.type (aa_sat_modello.id / aa_sat_type_fu.FK_product_model). Non usare i cod card GPS (555/556/731) come type SAT.
https://api.infodrive.it/products/List/
Elenco di tutti i servizi abbinabili alla Card principale, presenti a listino.
https://api.infodrive.it/products/ListAbb/
Il webservice consente l'attivazione di prodotti e servizi in due modalità differenti. Scegli la modalità di attivazione che più si adatta alle tue esigenze.
Questa modalità prevede l'attivazione dei prodotti e servizi generando in contemporanea una fattura al Cliente Finale.
Consente la creazione di un ordine con uno o più servizi/prodotti Infodrive.
https://api.infodrive.it/invoice/Insert/
satè disponibile solo in modalità di produzione
Consente l'aggiunta di uno o più prodotti all'ordine.
https://api.infodrive.it/invoice/{OrderID}/Edit/AddProducts/
satè disponibile solo in modalità di produzione
Consente l'eliminazione di uno o più prodotti dall'ordine.
https://api.infodrive.it/invoice/{OrderID}/Edit/DeleteProducts/
satè disponibile solo in modalità di produzione
Consente la modifica dell'importo della fattura.
https://api.infodrive.it/invoice/{OrderID}/Edit/Amount/
La visualizzazione dei PDF è disponibile solo in modalità di produzione.
Consente la modifica dei dati anagrafici del cliente.
https://api.infodrive.it/invoice/{OrderID}/Edit/Customer/
La visualizzazione dei PDF è disponibile solo in modalità di produzione.
Consente la modifica dei dati del veicolo.
https://api.infodrive.it/invoice/{OrderID}/Edit/Vehicle/
La visualizzazione dei PDF è disponibile solo in modalità di produzione.
Elimina un ordine con tutti i servizi inclusi.
https://api.infodrive.it/invoice/{OrderID}/Delete/
Elenco di tutti gli ordini presenti a sistema.
https://api.infodrive.it/invoice/List/
Restituisce i servizi dettagliati contenuti in un ordine.
https://api.infodrive.it/invoice/{OrderID}/Detail/
La visualizzazione dei PDF è disponibile solo in modalità di produzione.
Questa modalità prevede l'attivazione dei prodotti e servizi. Sarà possibile scegliere se emettere fattura servizi al rivenditore o al cliente finale.
N.B: Nel caso nella stessa chiamata vogliate attivare più prodotti contemporaneamente allo stesso cliente, basterà passare un array composto da più JSON richiesta
Consente la creazione di un ordine con uno o più servizi/prodotti Infodrive.
https://api.infodrive.it/contract/Activate/
satè disponibile solo in modalità di produzione
Consente la modifica del prezzo di rivendita a Cliente finale presente sul modulo di attivazione.
https://api.infodrive.it/contract/{ContractID}/Edit/Amount/
La visualizzazione dei PDF è disponibile solo in modalità di produzione.
Consente la modifica dei dati anagrafici del cliente.
https://api.infodrive.it/contract/{ContractID}/Edit/Customer/
La visualizzazione dei PDF è disponibile solo in modalità di produzione.
Consente la modifica dei dati del veicolo.
https://api.infodrive.it/contract/{ContractID}/Edit/Vehicle/
La visualizzazione dei PDF è disponibile solo in modalità di produzione.
Elimina un contratto servizi.
https://api.infodrive.it/contract/Delete/
Elenco di tutti i contratti presenti a sistema.
https://api.infodrive.it/contract/Directory/
Restituisce i contratti attivati ricercando per targa, numero di contratto, dati del cliente. La ricerca verrà effettuata verificando la presenza di tutti i parametri presenti in contemporanea (condizione "and") e non in esclusiva (condizione "or")
https://api.infodrive.it/contract/Search/
La visualizzazione dei PDF è disponibile solo in modalità di produzione.
Questa modalità prevede l'attivazione delle sotto utenze.
Consente la creazione di una sottoutenza
https://api.infodrive.it/user/Add/
Elenco di tutte le sottoutenze presenti a sistema.
https://api.infodrive.it/user/List/
https://api.infodrive.it/user/getStore/
Verifica se una marchiatura dello store di un utente è libera (non ancora utilizzata) o occupata (già associata a una tessera). Endpoint complementare a getStore, che restituisce l'elenco delle marchiature disponibili.
https://api.infodrive.it/user/checkMarchiatura/
Il prefisso/suffisso ID nel numero marchiatura viene ignorato in normalizzazione (es. ID12345ID → 12345). È obbligatorio almeno uno tra marchiatura e numero_marchiatura.
Endpoint per piattaforme esterne: elenco personalizzazioni, verifica email e registrazione di un account app già verificato, con veicolo e fidelizzazione.
Restituisce le personalizzazioni app associate ai rivenditori della piattaforma (agente = id_venditore_piattaforma), per l'app Infodrive (id_app = 1). Usare id_personalizzazione nella chiamata di registrazione account.
https://api.infodrive.it/app/getList/
Storico notifiche su account_app_notifiche con flag notifica_letta / data_lettura (stesso pannello "Notifiche Inviate" Siris). La conferma lettura è impostata dall'app all'apertura della notifica: non esiste oggi un webhook OneSignal inbound; usare polling su questo endpoint o su 7.11.
https://api.infodrive.it/app/ListNotifications/
Interroga lo stato di una o più notifiche tramite id_notifica restituito da SendPushNotification. Usare in polling dopo l'invio.
https://api.infodrive.it/app/GetNotificationStatus/
Non è un webhook OneSignal: lo stato letta arriva quando l'utente apre la notifica in app (flag notifica_letta).
Crea un account app già verificato (account_app_global.verificato = si), con fidelizzazione alla personalizzazione indicata e veicolo associato con servizio verificato. La password è generata automaticamente dal sistema e restituita in chiaro nella risposta.
https://api.infodrive.it/app/RegisterVerifiedAccount/
id_personalizzazione si ottiene dalla chiamata 7.1 getList.account_app_global, la chiamata restituisce errore 409.
Verifica se esiste già un account in account_app_global per l'email indicata. Utile prima di chiamare 7.2 RegisterVerifiedAccount.
https://api.infodrive.it/app/CheckAccount/
http_code 200 se l'email è valida: usare il flag exists.anagrafica.email come alternativa a email in root.
Invia una notifica push OneSignal a uno o più account app. Il target tipico è l'email dell'account (come in Gestione Account Siris / app custom). Il sistema risolve i device registrati in account_app_onesignal, scrive lo storico in account_app_notifiche e inoltra la push a OneSignal.
https://api.infodrive.it/app/SendPushNotification/
id_app = 49 (stesso valore della pagina app/custom/siris).player_id OneSignal valido (app non aperta / consenso notifiche), compare in no_player e non riceve la push.L'endpoint interno area riservata app/sendNotification (usato dalla UI) lavora con id_account. Questa API pubblica accetta principalmente email; opzionalmente anche id_account.
Restituisce gli account legati a un'id_app (stesso elenco della tab Account/Clienti in app/custom/siris). Utile per lo stato "App scaricata" senza chiamare CheckAccount uno-a-uno.
https://api.infodrive.it/app/ListAccounts/
id_app = 49.has_onesignal = true indica consenso/dispositivo push registrato.only_with_push = true filtra solo account con player OneSignal (come l'elenco notifiche UI).Verifica fino a 500 email in una sola chiamata. Con id_app arricchisce ogni riga con app_linked e has_onesignal.
https://api.infodrive.it/app/CheckAccounts/
Pubblica un'offerta in vetrina app (app_vetrina_offerte), equivalente a "Gestisci Offerte" in Siris. L'immagine non è una colonna separata: come in UI, si inserisce come tag <img> nella descrizione (campo image_url).
https://api.infodrive.it/app/CreateOffer/
Upload file: usare l'upload AWS già usato da Siris (https://servizi.infodrive.it/web/api/aws/cloud/1.0/upload.php), poi passare l'URL restituito in image_url.
Aggiorna un'offerta esistente. Richiede id (o id_offerta) e id_app. Campi omessi restano invariati; attiva/active controlla la visibilità in app.
https://api.infodrive.it/app/UpdateOffer/
Elenco offerte vetrina per id_app. Con active_only=true restituisce solo quelle visibili in app.
https://api.infodrive.it/app/ListOffers/
Abbina un IMEI libero a cliente/veicolo. Il campo sat.type è l'id di aa_sat_modello (stesso valore di aa_sat_type_fu.FK_product_model), non il cod delle card GPS (gps_obd_standard 555, gps_filare_standard 556, gps_ghost 731) e non il default 1.
https://api.infodrive.it/sat/Insert/
satellitari.modello = aa_sat_modello.nome_modello → aa_sat_modello.id = sat.type.sat/Free/ restituisce anche type, modello, nome_modello per ogni IMEI libero.products/List/ include le righe type: "sat" con il cod da usare in Insert (listino aa_sat_type_fu dell'utente OAuth).sat.type manca o vale 1, Infodrive lo ricava dall'IMEI. Durata (es. 60) deve comunque esistere a listino per quel type.Errore 406 "Non disponi della tipologia di sat...": coppia utente OAuth + FK_product_model + duration assente in aa_sat_type_fu (active). Non usare i codici card 555/556/731.