Web Services
2 1 Sommario 1 GENERALITÀ... 3 1.1 SCOPO.3 1.2 DEFINIZIONI.3 2 REQUISITI FUNZIONALI... 3 2.1 AUTENTICAZIONE..3 2.1.1Profili..3 2.2 SERVIZI DISPONIBILI 3 3 SERVIZIO AUTENTICAZIONE... 4 3.1 WEB SERVICE DISPLAYSERVICE 4 4 SERVIZIO AZIONARIO ITALIA WEB SERVICES DISPONIBILI... 4 4.1 WEB SERVICE SEARCHDISPLAYSERVICE..4 4.1.1 Popolamento combo Titolo nella form di ricerca 4 4.1.2 Ricerca effettiva.5 4.2 WEB SERVICE DISPLAYSERVICE..5 4.3 MERCATO DIURNO UTILIZZO DEI WEB SERVICES...5 4.3.1 Listino Principale (MTA)..5 4.3.2 Nuovo Mercato (MTAX) 5 4.3.3 ETF..6 4.3.4 Diritti..6 4.3.5 Dettaglio Titolo Listino Principale, Nuovo Mercato, ETF, Diritti...6 4.3.6 Prezzo corrente...7 4.4 MERCATO AFTER HOURS UTILIZZO DEI WEB SERVICES. 7 4.4.1 Listino Principale.7 4.4.2 Nuovo Mercato.7 4.4.3 Dettaglio Titolo Listino Principale, Nuovo Mercato.8 4.4.4 Prezzo corrente 8 5 SERVIZIO COVERED WARRANT WARRANT WEB SERVICES DISPONIBILI 9 5.1 WEB SERVICE BASKETDISPLAYSERVICE..10 5.2 WEB SERVICE SEARCHDISPLAYSERVICE.10 5.2.1 Popolamento form di ricerca..10 5.2.2 Ricerca effettiva.11 5.3 WEB SERVICE DISPLAYSERVICE..11 5.4 WARRANT UTILIZZO DEI WEB SERVICES.12 5.4.1 Ricerca titoli Warrant 12 5.4.2 Dettaglio Titolo Warrant mercato diurno..12 5.5 SERVIZIO COVERED WARRANT DIURNO UTILIZZO DEI WEB SERVICES 12 5.5.1 Ricerca titoli Covered Warrant mercato diurno..12 5.5.2 Dettaglio Titolo Covered Warrant mercato diurno.13 5.6 SERVIZIO COVERED WARRANT TAH 13 5.6.1 Ricerca titoli Covered Warrant TAH..13 5.6.2 Dettaglio Titolo Covered Warrant mercato TAH 13 6 SERVIZIO OBBLIGAZIONI WEB SERVICES DISPONIBILI... 14 6.1 WEB SERVICE SEARCHDISPLAYSERVICE 14 6.1.1 Popolamento combo Titolo nella form di ricerca.14 6.1.2 Ricerca effettiva..14 6.2 WEB SERVICE DISPLAYSERVICE.14 6.3 BOT UTILIZZO DEI WEB SERVICES.14 6.4 TITOLI DI STATO UTILIZZO DEI WEB SERVICES 15 6.5 OBBLIGAZIONI UTILIZZO DEI WEB SERVICES 15 6.6 DETTAGLIO TITOLO BOT, TITOLI DI STATO, OBBLIGAZIONI UTILIZZO DEI WEB SERVICES.16 6.7 PREZZO CORRENTE UTILIZZO DEI WEB SERVICES 16 7 SERVIZIO AZIONARIO ESTERO WEB SERVICES DISPONIBILI... 16 7.1 WEB SERVICE SEARCHDISPLAYSERVICE 16 7.2 WEB SERVICE DISPLAYSERVICE.17 7.3 LISTINO UTILIZZO DEI WEB SERVICES..17 7.4 DETTAGLIO TITOLO UTILIZZO DEI WEB SERVICES 17 7.5 PREZZO CORRENTE UTILIZZO DEI WEB SERVICES.18 8 NOTE... 18
3 Generalità Scopo Il presente documento ha l obiettivo di illustrare la logica di funzionamento dei Web Services forniti da Borsa Italiana. Definizioni Termine Web Service SOAP Token Definizione Sistema software implementato per consentire l interoperabilità tra sistemi diversi tra loro, posizionati su una stessa rete. Protocollo per lo scambio di messaggi tra componenti software. Stringa criptata e univoca necessaria per l autenticazione di un utente. Requisiti Funzionali Autenticazione Tutta la comunicazione avviene server side, ossia la piattaforma di Home Banking del Cliente effettua richieste dei dati verso i Web Services di Borsa Italiana esposti. L applicazione del cliente provvede, come primo passaggio, ad effettuare chiamata al metodo di Autenticazione inserendo username e password relativi al profilo dell utente che effettua la richiesta. In risposta a tale chiamata, il metodo restituisce un token utilizzato per tutte le richieste successive allo scopo di autenticare l applicazione del Cliente con il profilo dell utente, mediante inclusione in un SOAP Header dei successivi messaggi SOAP. Se l autenticazione non va a buon fine:? il server ritorna un codice http 500;? viene generato un SOAP Fault contenente la descrizione dell errore. Il token ha una durata di 10 minuti (valore attuale) scaduta la quale l applicazione del cliente deve provvedere a riautenticarsi per creare un altro token. Profili Ogni utente del servizio di Home Banking del Cliente ha un profilo di visualizzazione dei dati all interno dell Informativa erogata tramite il Market Connect Web. Il profilo creato all interno dell applicazione Market Connect Web permetterà la visualizzazione dei dati in modo coerente con la profilazione associata al servizio di Informativa (Delay Time vs. Real Time). Servizi disponibili Riportiamo nella tabella di seguito la lista delle funzionalità standard richieste dal cliente. ACCESSO DIRETTO: principali funzionalità Ricerca prezzo corrente titolo Ricerca per stringa descrittiva con opzione "Inizia con " su mercato "Az. Italia" e tipi "listino principale", "nuovo mercato", "ETF" o "diritti" Ricerca per stringa descrittiva con opzione "Contiene " su mercato "Az. Italia" e tipi "listino principale", "nuovo mercato", "ETF" o "diritti" Ricerca per stringa descrittiva con opzione "Esatto" su mercato "Az. Italia" e tipi "listino principale", "nuovo mercato", "ETF" o "diritti" Ricerca per stringa descrittiva con opzione "Inizia con " su mercato "After Hours" e tipi "listino principale" o "nuovo mercato" Ricerca per stringa descrittiva con opzione "Contiene " su mercato "After Hours" e tipi "listino principale" o "nuovo mercato"
4 Ricerca per stringa descrittiva con opzione "Esatto" su mercato "After Hours" e tipi "listino principale" o "nuovo mercato" Ricerca su borsa estera selezionato dai listini disponibili (Amsterdam, Bruxelles, ). Ricerca su listino New York NYSE per lettera iniziale Ricerca covered warrant per emittente Ricerca covered warrant per sottostante Ricerca tutti i warrant Ricerca BOT per vita residua da oggi a n mesi Ricerca BOT per codice isin Ricerca tutti i BOT Ricerca Titoli di Stato per tipo (BTP, ) Ricerca Titoli di Stato per anno di scadenza Ricerca Titoli di Stato per codice isin Ricerca tutti i Titoli di Stato Ricerca tutte le obbligazioni Dettaglio titolo di un mercato specifico Nei paragrafi successivi illustreremo nel dettaglio il funzionamento dei Web Services. Servizio Autenticazione Web Service DisplayService Nome del Web Service: DisplayService Metodo da invocare: autenticate(string username, String password) Per chiamare questo servizio è necessario il passaggio di due parametri:? username? password Il servizio restituisce al metodo che l ha invocato un parametro, necessario per il riconoscimento dell utente nelle richieste successive:? token. Servizio Azionario Italia Web Services disponibili La ricerca dei titoli del Mercato Azionario consente al momento di effettuare ricerca degli strumenti del mercato diurno e del mercato serale. All interno delle 2 macro categorie di ricerca è obbligatorio selezionare il mercato di riferimento del titolo ossia:? Listino Principale (mercato MTA);? Nuovo Mercato (mercato MTAX);? ETF (non disponibile nella ricerca TAH);? Diritti (non disponibile nella ricerca TAH). Sempre all interno delle form è obbligatorio inserire la descrizione degli strumenti da ricercare secondo 3 diverse modalità:? Inizia con ;? Contiene ;? Esatto. Web Service SearchDisplayService Nome del Web Service: SearchDisplayService Popolamento combo Titolo nella form di ricerca Metodo da invocare: getlistazioniitalia (Boolean tah)
5 Questo metodo è utilizzato per il popolamento della combo Titolo nella pagina Inserimento Ordine di Compravendita del mercato azionario italiano diurno e serale. Restituirà una lista contente le coppie descrizione titolo, isin. Descrizione dei parametri:? tah: è booleano e quindi può assumere i valori: true, false. Ricerca effettiva Metodo da invocare: getazioniitalia(string grp, Boolean tah, String titolo, String tiporicerca) Questo metodo è necessario per la ricerca di uno strumento. Descrizione dei parametri:? grp: può assumere i valori: mta, nm, etf, diritti ;? tah: è booleano e quindi può assumere i valori: true, false.? titolo: corrisponde al nome dello strumento e deve essere almeno di tre caratteri? tiporicerca: può assumere i valori: iniziacon, esatto, contiene. Tutti i parametri sono obbligatori e devono essere valorizzati secondo le condizioni indicate, altrimenti la ricerca non produrrà nessun risultato. Web Service DisplayService Nome del Web Service: DisplayService Invocare uno tra questi metodi:? getmtadisplay(string isin) metodo di default con tah=false;? getmtadisplay(string isin, boolean tah);? getmtadisplay(string isin, boolean tah, String[] params) Per richiedere il prezzo corrente del titolo specificare i seguenti parametri:? String params[] = { ultimoprezzo, oraultimoprezzo }. Questo metodo è necessario per richiedere il dettaglio di un titolo e il prezzo corrente di un titolo. Mercato diurno Utilizzo dei Web Services Listino Principale (MTA) (ws: SearchDisplayService; metodo: getazioniitalia)? grp = mta ;? tah=false; (boolean)? titolo (almeno tre caratteri);? tipologia = iniziacon / contiene / esatto. Nuovo Mercato (MTAX) (ws: SearchDisplayService; metodo: getazioniitalia)
6? grp = nm ;? tah=false; (boolean)? titolo (almeno tre caratteri);? tipologia = iniziacon / contiene / esatto. ETF (ws: SearchDisplayService; metodo: getazioniitalia)? grp = etf ;? tah=false; (boolean)? titolo (almeno tre caratteri);? tipologia = iniziacon / contiene / esatto. Diritti (ws: SearchDisplayService; metodo: getazioniitalia)? grp= diritti ;? tah=false; (boolean)? titolo (almeno tre caratteri);? tipologia= iniziacon / contiene / esatto. Dettaglio Titolo Listino Principale, Nuovo Mercato, ETF, Diritti (ws: DisplayService; metodo: getmtadisplay)? codice ISIN;? tah=false; (boolean).
7? Dati Ultimo contratto: o Ultimo Prezzo; o Quantità; o Ora; o Variazione %;? Dati Giornalieri: o Pz. Apertura; o Pz. Minimo; o Quantità; o Pz. Ufficiale; o Q.tà apertura; o Pz. Massimo; o Num. Contratti; o Pz. Riferimento;? Dati Seduta Precedente: o Data Seduta; o Pz. Ufficiale; o Pz. Riferimento. Prezzo corrente (ws: DisplayService; metodo: getmtadisplay)? codice ISIN;? tah (boolean: true = tah, false = diurno). Mercato After Hours Utilizzo dei Web Services Listino Principale (ws: SearchDisplayService; metodo: getazioniitalia)? grp = mta ;? tah=true; (boolean)? titolo (almeno tre caratteri);? tipologia = iniziacon / contiene / esatto. Nuovo Mercato (ws: SearchDisplayService; metodo: getazioniitalia)? grp = nm ;? tah=true; (boolean)? titolo (almeno tre caratteri);? tipologia = iniziacon / contiene / esatto.
8 Dettaglio Titolo Listino Principale, Nuovo Mercato (ws: DisplayService; metodo: getmtadisplay)? codice ISIN;? tah = true. (boolean)? Dati Ultimo contratto: o Ultimo Prezzo; o Quantità; o Ora; o Variazione %;? Dati Giornalieri: o Pz. Massimo; o Pz. Minimo; o Quantità Totale; o Controvalore; o Pz. Medio; o Pz Medio seduta precedente; o Var.% Pz Medio. Prezzo corrente (ws: DisplayService; metodo: getmtadisplay)? codice ISIN;? tah (boolean: true = tah, false = diurno).
9 Servizio Covered Warrant Warrant Web Services disponibili La ricerca dei titoli Warrant consente al momento di effettuare la ricerca degli strumenti Warrant e degli strumenti Covered Warrant, questi ultimi relativi sia al mercato diurno che al mercato serale. Per quanto riguarda, invece, gli strumenti Covered Warrant, la ricerca è suddivisa in due fasi consecutive. La prima fase prevede la restituzione da parte del servizio, di tutti i parametri necessari alla costruzione di una form di ricerca. Il metodo coinvolto è getsedexsearch, il quale, a fronte del passaggio della tipologia dello strumento e del parametro che indica se il mercato è diurno o serale, restituisce un insieme di parametri che il cliente può usare per la costruzione della suddetta form. Di seguito forniamo un immagine di esempio di una form di ricerca. Il cliente sarà comunque libero di gestire i dati restituiti dal servizio e di visualizzare le combo nel modo che ritiene più adeguato. La seconda fase comprende la ricerca effettiva degli strumenti. I metodi coinvolti sono getsedexbasket e getsedexbaskettah. Il primo metodo deve essere invocato nel caso in cui, nella prima fase sia stato passato il parametro che indica mercato diurno. Il secondo metodo deve essere invocato nel caso in cui, nella prima fase sia stato passato il parametro che indica mercato serale. I parametri da passare e quelli restituiti sono dettagliati nei paragrafi successivi. Di seguito forniamo un piccolo schema logico che illustra il funzionamento del servizio.
10 Web Service BasketDisplayService Nome del Web Service: BasketDisplayService Metodi da invocare: getwarrant() Il metodo è necessario per visualizzare la lista degli strumenti Warrant. Parametri: nessuno Web Service SearchDisplayService Nome del Web Service: SearchDisplayService Popolamento form di ricerca Metodo da invocare: getsedexsearch(string tipo, Boolean tah) Questo metodo è utilizzato per popolare la form allo scopo di impostare la ricerca effettiva degli strumenti Covered Warrant. Parametri da passare per il popolamento della form di ricerca:? tipo = plainvanilla / lev_cartificates / inv_certificates / esotici ;? tah = true; / tah = false. Parametri restituiti per il popolamento della form di ricerca relative al tipo scelto:
11? Lista Tipologia,? Lista Emittente? Lista sottostanti Indici,? Lista sottostanti Azioni Italiane,? Lista sottostanti Azioni Estere,? Lista sottostanti Valute,? Lista sottostanti Altro,? Lista sottostanti Materie Prime,? Lista sottostanti Tassi di Interesse. Ricerca effettiva Metodo da invocare: getsedexbasket(string grp, String alfacode, Date datascad, String codtipoprod, String codemit) Metodo da invocare: getsedexbaskettah(string grp, String alfacode, Date datascad, String codtipoprod, String codemit) Questi metodi sono necessari per effettuare una ricerca tra gli strumenti Covered Warrant. Descrizione dei parametri:? Il parametro codtipoprod corrisponde al valore scelto nella combo Tipologia? Il parametro codemit corrisponde al valore scelto nella combo Emittente? Il parametro datascad corrisponde al valore scelto nella combo Data Scadenza? Il parametro alfacode corrisponde al valore scelto nelle combo Valore del Sottostante, selezionato tra Indici, Azioni Italiane, Azioni Estere, Valute, Altro, Materie Prime? Il parametro grp può assumere i seguenti valori, in base alle scelte effettuate all interno delle combo: Covered Warrant Sottostante Grp Plain Vanilla Indici MTDVanillaIndici Azioni Italiane MTDVanillaAzioniIt Azioni Estere MTDVanillaAzioniEst Valute MTDVanillaValuta Altro MTDVanillaAltro Materie Prime MTDVanillaMateriePrime Tassi di Interesse MTDVanillaTassiInt Leverage Certificates Indici MTDLevCertificatesIndici Azioni Italiane MTDLevCertificatesAzioniIt Azioni Estere MTDLevCertificatesAzioniEst Valute MTDLevCertificatesValuta Altro MTDLevCertificatesAltro Materie Prime MTDLevCertificatesMateriePrime Tassi di Interesse MTDLevCertificatesTassiInt Investment Certificates Indici MTDInvCertificatesIndici Azioni Italiane MTDInvCertificatesAzioniIt Azioni Estere MTDInvCertificatesAzioniEst Valute MTDInvCertificatesValute Altro MTDInvCertificatesAltro Materie Prime MTDInvCertificatesMateriePrime Tassi di Interesse MTDInvCertificatesTassiInt Strutturati/Esotici Indici MTDEsoticiIndici Azioni Italiane MTDEsoticiAzioniIt Azioni Estere MTDEsoticiAzioniEst Valute MTDEsoticiValuta Altro MTDEsoticiAltro Materie Prime MTDEsoticiMateriePrime Tassi di Interesse MTDEsoticiTassiInt Tutti i parametri sono obbligatori a meno della datascad, e devono essere valorizzati secondo le condizioni indicate, altrimenti la ricerca non produrrà nessun risultato. Web Service DisplayService Nome Web Service: DisplayService Invocare uno tra questi metodi:
12? getsedexdisplay(string isin) default tah false;? getsedexdisplay (String isin, boolean tah);? getsedexdisplay (String isin, boolean tah, String[] params) Questo metodo è necessario per richiedere il dettaglio di un titolo. Warrant Utilizzo dei Web Services Ricerca titoli Warrant (ws: BasketDisplayService; metodo: getwarrant) Nessun parametro da passare per la richiesta. Dettaglio Titolo Warrant mercato diurno (ws: DisplayService; metodo: getmtadisplay) Parametri da passare per la ricerca:? tah = false; (boolean).? Dati Ultimo contratto: o Ultimo Prezzo; o Quantità; o Ora; o Variazione %;? Dati Giornalieri: o Pz. Apertura; o Pz. Minimo; o Quantità; o Pz. Ufficiale; o Q.tà apertura; o Pz. Massimo; o Num. Contratti; o Pz. Riferimento;? Dati Seduta Precedente: o Data Seduta; o Pz. Ufficiale; o Pz. Riferimento. Servizio Covered Warrant Diurno Utilizzo dei Web Services Ricerca titoli Covered Warrant mercato diurno (ws: SearchDisplayService; metodo: getsedexbasket) Si fa riferimento al sottoparagrafo 6.2.2 per la descrizione dei parametri.
13 Dettaglio Titolo Covered Warrant mercato diurno (ws: DisplayService; metodo: getsedexdisplay) Parametri da passare per la ricerca:? tah = false (boolean).? Dati Ultimo contratto: o Ultimo Prezzo; o Quantità; o Ora; o Variazione %;? Dati Giornalieri: o Pz. Apertura; o Pz. Minimo; o Quantità; o Pz. Ufficiale; o Q.tà apertura; o Pz. Massimo; o Num. Contratti; o Pz. Riferimento;? Dati Seduta Precedente: o Data Seduta; o Pz. Ufficiale; o Pz. Riferimento. Servizio Covered Warrant TAH Ricerca titoli Covered Warrant TAH (ws: SearchDisplayService; metodo: getsedexbaskettah) Si fa riferimento al sottoparagrafo 6.2.2 per la descrizione dei parametri. Dettaglio Titolo Covered Warrant mercato TAH (ws: DisplayService; metodo: getsedexdisplay)? codice ISIN;? tah = true. (boolean)
14? Dati Ultimo contratto: o Ultimo Prezzo; o Quantità; o Ora; o Variazione %;? Dati Giornalieri: o Pz. Massimo; o Pz. Minimo; o Qtà. Totale; o Controvalore; o Prezzo Medio; o Prezzo Medio seduta prec.; o Variazione % Prezzo Medio. Servizio Obbligazioni Web Services disponibili Web Service SearchDisplayService La ricerca dei titoli Obbligazionari consente di effettuare ricerca degli strumenti così suddivisi:? Obbligazioni;? BOT;? Titoli di Stato. Nome del Web Service: SearchDisplayService Popolamento combo Titolo nella form di ricerca Metodo da invocare: getlisttitolistato() Questo metodo è necessario per il popolamento della combo Titolo nella pagina Inserimento Ordine di Compravendita del mercato MOT per gli strumenti della categoria Titoli di Stato. Restituirà una lista contente le coppie descrizione titolo, isin. Ricerca effettiva Metodo da invocare: getmot(string grp, Date scadenza, String isin, String emittente) La valorizzazione dei parametri viene descritta nei paragrafi che seguono. Il parametro grp è obbligatorio. Web service DisplayService Nome del Web Service: DisplayService Metodi da invocare:? getmotdisplay(string isin);? getmotdisplay(string isin, String[] params) Questo metodo è necessario per richiedere il dettaglio di un titolo. Per richiedere il prezzo corrente del titolo specificare i seguenti parametri:? String params[] = { ultimoprezzo, oraultimoprezzo }. BOT Utilizzo dei Web Services (ws: SearchDisplayService; metodo: getmot)? grp = bot ;? scadenza = data valorizzato esclusivamente per ricerca su Vita residua, altrimenti nullo;
15? codice isin valorizzato esclusivamente per ricerca su ISIN, altrimenti nullo;? codice isin società emittente non applicabile per BOT, quindi nullo; o Descrizione; o Codice ISIN;? Asta o Prezzo; o Fase;? Sottoscrizione o Prezzo; o Ora;? Ul. Prez. Valido o Prezzo; o Data. Titoli di Stato Utilizzo dei Web Services (ws: SearchDisplayService; metodo: getmot)? grp = btp ; cct ; ctz - deve essere passato uno solo tra questi valori;? scadenza = data valorizzato esclusivamente per ricerca su Anno Scadenza (31/12/<anno>), altrimenti nullo;? codice isin valorizzato esclusivamente per ricerca su ISIN, altrimenti nullo;? codice isin società emittente non applicabile per Titolo di Stato, quindi nullo. o Descrizione; o Codice ISIN;? Asta o Prezzo; o Fase;? Sottoscrizione o Prezzo; o Ora;? Ul. Prez. Valido o Prezzo; o Data. Obbligazioni Utilizzo dei Web Services (ws: SearchDisplayService; metodo: getmot)? grp = obbl ;? scadenza = data non applicabile, quindi nullo;? codice isin non applicabile, quindi nullo;? codice isin società emittente. o Descrizione; o Codice ISIN;? Asta o Prezzo; o Fase;? Sottoscrizione o Prezzo; o Ora;? Ul. Prez. Valido o Prezzo; o Data.
16 Dettaglio Titolo BOT, Titoli di Stato, Obbligazioni Utilizzo dei Web Services (ws: DisplayService; metodo: getmotdisplay)? Dati Giornalieri: o Pz. Asta, o Fase Asta, o Pz. Sottoscrizione, o Ora Sottoscrizione, o Ultimo Pz. Valido, o Data;? Dati Emissione: o Pz. Emissione; o Data Emissione; o Data Scadenza; o Vita Residua;? Dati Rendimento: o Rend. Immediato; o Rend. Effettivo; o Rateo; (non compare per BOT) o Cedola; (non compare per BOT) o I Stacco; (non compare per BOT) o II Stacco; (non compare per BOT) Prezzo corrente Utilizzo dei Web Services (ws: DisplayService; metodo: getmotdisplay) Parametro da passare per la richiesta: Servizio Azionario Estero Web Services Disponibili All interno di questa sezione è possibile effettuare, sulla base del mercato selezionato all interno del menù a tendina Listino, una ricerca per i titoli appartenenti ai panieri esteri di riferimento, ossia:? Aex;? Bel20;? Dax30;? FTSE100;? Ibex35;? Cac40;? Smi30;? S&P500. Web Service SearchDisplayService Nome del Web Service: SearchDisplayService Metodo da invocare: getazioniestero(string listino, String lettera). Questo metodo è necessario per la ricerca di uno strumento. Parametri da passare per la ricerca:? listino: AEX ; / BEL20 ; / DAX100 ; / FTSE100 ; / IBEX35 ; / CAC40 ; / SMI ; / NASDAQ ; / NYSE. È un parametro obbligatorio? lettera: iniziale del titolo; costituisce un parametro obbligatorio per i titoli del paniere S&P500 quotati sul mercato NYSE.
17 Web Service DisplayService Nome del Web Service: DisplayService Invocare uno tra questi metodi:? getdisplayestero(string idint);? getdisplayestero(string idint, String[] params) Questo metodo è necessario per richiedere il dettaglio di un titolo. Per richiedere il prezzo corrente del titolo specificare i seguenti parametri:? String params[] = { ultimoprezzo, oraultimoprezzo }. Listino Utilizzo dei Web Services (ws: SearchDisplayService; metodo: getazioniestero) Si fa riferimento al paragrafo 8.1 per la descrizione dei parametri. Dettaglio Titolo Utilizzo dei Web Services (ws: DisplayService; metodo: getdisplayestero)? Codice IdInt;? Dati Ultimo contratto: o Ultimo Prezzo; o Quantità; o Ora; o Variazione %;? Dati Giornalieri: o Pz. Apertura; o Pz. Massimo; o Pz. Minimo; o Q.tà Totale; o Controvalore; o Num. Contratti; o Pz. Riferimento; o Pz. Riferimento seduta precedente.
18 Prezzo corrente Utilizzo dei Web Services (ws: DisplayService; metodo: getdisplayestero) Parametro da passare per la richiesta:? Codice Int. Note È opportuno che il cliente preveda delle politiche di caching dei dati restituiti dai Web Services, al fine di evitare un eccessivo numero di chiamate, con il conseguente sovraccarico dei sistemi.