Tassi di Cambio REST API (Versione 1.0)

Documenti analoghi
Specifica tecnica dei servizi di integrazione

Digital Distribution Web Services (DDWS) GetMyPrice - Manuale di servizio

Documentazione API web v 1.0

Currency Converter (conversione di valute)

Contents SPECIFICHE TECNICHE API TRASPORTO UPELA

Web API. Guida all uso

Esercitazione 1 SQL: DDL e DML di base

Tito Flagella - Il protocollo HTTP

Sicurezza delle applicazioni web: protocollo HTTP

Introduzione. Java HTTP. G. Prencipe

I servizi del SITR-IDT

Digital Distribution Web Services (DDWS) Manuale del servizio GetPartnerDesignation

Stack protocolli TCP/IP

REGIONE PIEMONTE SERVIZI SIGMATER ESTRATTO MANUALE DI UTILIZZO SISTEMA INFORMATIVO DELLA REGIONE PIEMONTE SERVIZI SIGMATER

Corso di Telematica II

Direzione Centrale Sistemi Informativi e Tecnologici

AdvSelf Italia Srl. Manuale Gateway HTTP AdvSelf Italia srl - All Rights Reserved

Ipertesto (testo + link a risorse)

Digital Distribution Web Services (DDWS) Manuale del servizio GetLicense

ProgettoSMS. Manuale Gateway FTP Text

Documentazione API web v 1.0

MANUALE DI BASE PER UTILIZZO SOFTWARE PAGHE WEB

2Dove vogliamo arrivare:

Il protocollo HTTP. Caratteristiche del protocollo HTTP. Versioni del protocollo. Due tipologie di messaggi:

SMS Gateway - Specifiche WS. Specifica Tecnica

PROTOCOLLO DI COLLOQUIO MODELLO C59

Servizi di aggiornamento delle chiavi pubbliche relative agli strumenti di revisione

Prova d Esame Tecnologie Web LA A.A. 2008/2009 Tempo Disponibile: 3 ore Ai candidati è consentita la consultazione di manuali e materiale didattico

Laboratorio Progettazione Web Le funzioni in PHP. Angelica Lo Duca IIT-CNR 2012/2013

RICHIESTA CERTIFICATO DI AGIBILITÀ IMPRESE CHE OCCUPANO LAVORATORI DEL SETTORE DELLO SPETTACOLO

Utilizzo del modulo per aprire le commesse in Ardis

Progetto Gennaio 2016

Guida dell'api REST di Livebase

D3.7 Sviluppo di unità di test e report relativi ai moduli di interfacciamento tra il Portale di visualizzazione remota 3D e il MiddleWare.

Creare l array presentato nei lucidi ([pippo, pluto, etc])

<WEB SERVICE> PROPOSTA DEI SERVIZI

SVI Nuovo Sistema Revisioni

GEOPORTALE Arpa Piemonte

Portale WEB Mancata Produzione Eolica Formattazione File per invio Indisponibilità da portale MPE

PRESENTAZIONE DI UN SMS AL GATEWAY

PROGETTO TESSERA SANITARIA WEB SERVICES DI GESTIONE PASSWORD

WooCommerce: Configurare le aliquote di imposta Standard

Argomenti XML JSON. Linguaggi per la definizione e lo scambio di dati strutturati, semi-strutturati, non strutturati. XML Data Model JSON

Excel 3. Master Universitario di II livello in MANAGER NELLE AMMINISTRAZIONI PUBBLICHE A.A Prof.ssa Bice Cavallo

Real Time Streaming Protocol. Akshat Sikarwar - Columbia University Traduzione e adattamento di Massimo De Santo, Università di Salerno

4b. Esercizi sul livello di Rete Inoltro in IP

Turnover dei mercati dei cambi e dei prodotti derivati in Italia (milioni di dollari USA e valori percentuali)

Conservazione No Problem Documento Tecnico. Guida all Integrazione con il servizio di conservazione digitale a norma di Arancia ICT

Luca Mari, Sistemi informativi applicati (reti di calcolatori) appunti delle lezioni. Architetture client/server: applicazioni client

Tipi di pulsante, caselle di controllo e altri controlli sulla barra degli strumenti Moduli

Guida all utilizzo dell area riservata

Applicazioni e protocolli a livello applicazione

MANUALE DI INTEGRAZIONE API SMSSmart (v 2.2)

Referti on-line e CRM ReView Service Monitor Specifiche tecniche

Bilancio separato di Impregilo S.p.A. al 31 dicembre 2013

Prova di Esame - Rete Internet (ing. Giovanni Neglia) Lunedì 24 Gennaio 2005, ore 15.00

UTILIZZO DELLO STRUMENTO ANALISI DATI DI EXCEL 1 PER ANALISI DI CORRELAZIONE E STIMA DI MODELLI DI REGRESSIONE

Il Protocollo HTTP e la programmazione di estensioni Web

Sicurezza delle applicazioni web: protocollo HTTP

Appunti di Sistemi A cura del prof. ing. Mario Catalano. Internet e il Web

PROTOCOLLI APPLICATIVI PER INTERNET

Sicurezza delle applicazioni web: protocollo HTTP

Input. Il tipo char Alcune modalità di acquisizione di input. Laboratorio di Programmazione - Luca Tesei

FUNZIONI DI BASE PANNELLO SMS

IMPRESE SETTORE DELLO SPETTACOLO

MRS Service (Network Lookup) e Portability Documentazione tecnica Interfaccia QUERY

Le date in java. Date, Calendar, GregorianCalendar, SimpleDateFormat

PROGETTO OPESSAN MANUALE UTILIZZO DEI SERVIZI (PER ASL E ASO)

Esercitazione Google Maps

Attività correnti. Valore netto al Valore netto al svalutazione. svalutazione altri crediti Totale. commerciali. crediti.

- Manuale Operatore -

Lo strato di applicazione in Internet

Protocolli applicativi basati su TCP/IP

2.5. L'indirizzo IP identifica il computer di origine, il numero di porta invece identifica il processo di origine.

28/02/2014 Copyright V. Moriggia

Guida all'accesso alla reportistica Infoview per utenti Sisam e ImportSisam

INVIO DATI 730 SOLO PARAFARMACIE

Il comando provoca il salvataggio dello stato e la terminazione dell esecuzione.

Manuale NoiPA. NoiPAssicura

ORGANIZZAZIONE DI SISTEMI OPERATIVI E RETI

Anagrafe sanitaria della Regione Emilia Romagna. Servizi WEB per l accesso ai dati certificati.

Scritta da Andrea Cappa COME INSTALLARE LINUX IN UN HOST VIRTUALE

Architetture Web Protocolli di Comunicazione

MANUALE DI INTEGRAZIONE API DMM (v 2.5)

Manuale XML SERVICE FATTURA ELETTRONICA EASY. Version Description Author Date Approved Approved date V1 30/06/2014 V2 01/12/2014

Casalini Crypto. Documento di protocollo tecnico VRS 2.1

Events: Track your favorite artists


Ajax e jquery. Emiliano Castellina. Dipartimento di Automatica e Informatica Politecnico di Torino

Provvigioni differenti in base alla natura dell Agente vengono gestite grazie alla completa personalizzazione dei Gruppi Provvigionali.

Scelta del Browser. Accesso Area Redazione

Mantenimento dello stato

Tecnologie Web T DTD Document Type Definition

Guida a SacramentiWeb 1.2

Addendum al manuale del Pc-Prenotazione Ver (Cod )

Comunicato Stampa DIFFUSO A CURA DEL SERVIZIO SEGRETERIA PARTICOLARE

Specifiche API. Provisioning Rivenditore

Vestasoft S.r.l. Software per la Gestione degli impianti termici

Parte 6 JSON, Web Storage API, funzioni JavaScript e user script

Transcript:

Tassi di Cambio REST API (Versione 1.0) Per brevità nella descrizione delle URL si omette il dominio base, quindi, ad esempio, invece di https://tassidicambio.bancaditalia.it/terzevalute-wf-web/rest/v1.0/currencies scriviamo semplicemente /currencies. I parametri in input ripetibili saranno indicati nell'url tra parentesi quadre. Ultimi Cambi Fornisce i cambi, contro Euro e contro dollaro Usa, dell'ultimo giorno per cui sono disponibili le quotazioni tra tutte le valute in corso. GET /latestrates?lang= Media type: È possibile avere il risultato nei seguenti formati: json, pdf, csv, Excel, a seconda del parametro dell header HTTP Accept: Accept: application/json Accept: application/pdf Accept: text/csv Accept: application/vnd.ms-excel Parametri di input: Nome Obbligatorio Descrizione lang No Stringa identificativa della lingua in cui si desidera ottenere i dati: può valere it o en case insensitive. Se il parametro non viene specificato, o valorizzato in modo errato, i risultati saranno forniti nella lingua di default. Codici http di risposta: 200 OK 500 Internal Server Error 503 Service Unavailable 400 Bad Request 408 Request Timeout 404 Not Found 1

Esempi di risposta: Content Type: application/json "resultsinfo": "totalrecords": 2, "timezonereference": "Le date sono riferite al fuso orario dell'europa Centrale", "notice": "Quantita' di valuta estera per 1 Euro", "latestrates": [ "country": "AFGHANISTAN", "currency": "Afghani", "isocode": "AFN", "uiccode": "115", "eurrate": "1.0000", "usdrate": "1.0000", "usdexchangeconvention": "Quantita' di valuta estera per 1 Dollaro", "usdexchangeconventioncode": "C", "referencedate": "2017-08-18", "country": "AFGHANISTAN", "currency": "PROVA290", "isocode": "PRV", "uiccode": "909", "eurrate": "1.0000", "usdrate": "1.000000", "usdexchangeconvention": "Quantita' di valuta estera per 1 Dollaro", "usdexchangeconventioncode": "C", "referencedate": "2017-08-18" ] Content Type: text/csv Nome del file: ultimi_cambi_aaaammgg.csv Paese,Valuta,Codice ISO,Codice UIC,Euro,Dollaro USA,Convenzione di cambio contro Dollaro,Convenzione di cambio contro Euro,Data di riferimento (CET) AFGHANISTAN,Afghani,AFN,115,79.6447,68.3939,Quantita' di valuta estera per 1 Dollaro,Quantita' di valuta estera per 1 Euro,2017-11-02 ALBANIA,Lek,ALL,047,133.59,114.72,Quantita' di valuta estera per 1 Dollaro,Quantita' di valuta estera per 1 Euro,2017-11-02 ALGERIA,Dinaro Algerino,DZD,106,134.1344,115.1863,Quantita' di valuta estera per 1 Dollaro,Quantita' di valuta estera per 1 Euro,2017-11-02 ANGOLA,Readjustado Kwanza,AOA,087,193.132,165.850,Quantita' di valuta estera per 1 Dollaro,Quantita' di valuta estera per 1 Euro,2017-11-02 2

Cambi Giornalieri Fornisce i cambi giornalieri per una specifica data, contro Euro o contro Dollaro USA o contro Lira Italiana, di una o più valute richieste, che siano valide e per le quali sia disponibile la quotazione per la data selezionata. E' possibile non specificare le valute desiderate, in tal caso il servizio restituisce tutte le valute quotate. Qualora, per la data e le valute richieste, non esistano quotazioni, il servizio restituisce l'elenco vuoto con un messaggio informativo. GET /dailyrates?referencedate=[&basecurrencyisocode=]&currencyisocode=&lang= Media type: È possibile avere il risultato nei seguenti formati: json, pdf, csv, Excel, a seconda del parametro dell header HTTP Accept: Accept: application/json Accept: application/pdf Accept: text/csv Accept: application/vnd.ms-excel Parametri di input: Nome Obbligatorio Ripetibile Descrizione referencedate Si No Viene interpretata relativamente al fuso orario dell Europa Centrale nel seguente formato: "yyyy-mm-dd. formato errato, il servizio restituirà un messaggio con il formato Se la data inserita non esistono dati il servizio restituirà un elenco vuoto. basecurrencyisocode No Si Codice ISO (case insensitive) della valuta per cui si richiede la quotazione. Nel caso di più valute il parametro sarà ripetuto. Se il parametro non viene passato, si intendono tutte le valute per cui è disponibile la quotazione nella data richiesta. Codici ISO inesistenti verranno scartati. Se tutti i codici ISO inseriti sono inesistenti, verrà restituita una lista vuota. Se il parametro è specificato in un formato errato, il servizio restituirà un messaggio di errore. currencyisocode Si No Codice ISO (case insensitive) della valuta "contro" cui si vuole la quotazione. Può valere EUR, USD, ITL. Se il parametro non è specificato, o è specificato un valore diverso da quelli validi, il servizio restituirà un messaggio di errore. lang No No Lingua in cui si desidera ottenere i dati: può valere it o en (case insensitive). Se il parametro non viene specificato, o viene valorizzato in modo errato, i risultati saranno forniti nella lingua di default. Codici http di risposta: 200 OK 500 Internal Server Error 503 Service Unavailable 400 Bad Request 408 Request Timeout 404 Not Found 3

Esempi di risposta: Content Type: application/json "resultsinfo": "totalrecords": 1, "timezonereference": "Le date sono riferite al fuso orario dell'europa Centrale", "rates": [ "country": "EMIRATI ARABI UNITI", "currency": "Dirham Emirati Arabi", "isocode": "AED", "uiccode": "187", "avgrate": "4.13942", "exchangeconvention": "Quantita' di valuta estera per 1 Euro", "exchangeconventioncode": "I", "referencedate": "2016-08-17" ] Content Type: text/csv Nome del file: cambi_giornalieri_aaaammgg.csv Paese,Valuta,Codice ISO,Codice UIC,Quotazione,Convenzione di cambio, Data di riferimento (CET) AFGHANISTAN,Afghani,AFN,115,76.042074,Quantita' di valuta estera per 1 Euro,2016-08-17 ALBANIA,Lek,ALL,047,136.262894,Quantita' di valuta estera per 1 Euro,2016-08-17 ALGERIA,Dinaro Algerino,DZD,106,122.767026,Quantita' di valuta estera per 1 Euro,2016-08-17 ANGOLA,Readjustado Kwanza,AOA,087,188.250565,Quantita' di valuta estera per 1 Euro,2016-08-17 ANTIGUA E BARBUDA,Dollaro Caraibi Est,XCD,137,3.04452,Quantita' di valuta estera per 1 Euro,2016-08-17 4

Cambi Medi Mensili Fornisce i cambi medi mensili per uno specifico mese/anno, contro Euro o contro Dollaro USA o contro Lira Italiana, di una o più valute richieste, che siano valide e per le quali sia disponibile la quotazione. E' possibile non specificare le valute desiderate, in tal caso il servizio restituisce tutte le valute quotate. Qualora, per il mese e le valute richieste, non esistano quotazioni, il servizio restituirà un elenco vuoto. GET /monthlyaveragerates?month=&year=[&basecurrencyisocode=]&currencyisocode=&lang= Media type: È possibile avere il risultato nei seguenti formati: json, pdf, csv, Excel, a seconda del parametro dell header HTTP Accept: Accept: application/json Accept: application/pdf Accept: text/csv Accept: application/vnd.ms-excel Parametri di input: Nome Obbligatorio Ripetibile Descrizione month Si No Mese per cui si richiede la quotazione. Deve essere un intero compreso tra 1 e 12. Se il parametro non viene specificato, o è specificato un valore non consentito, il servizio restituirà un errore http 400 ed un messaggio indicante la necessità del parametro con un valore compreso tra 1 e 12. year Si No Anno per cui si richiede la quotazione. Deve essere un intero di 4 cifre nel formato YYYY. Se per la coppia mese/anno inserita non esistono dati il servizio restituirà un elenco vuoto. basecurrencyisocode No Si Codice ISO (case insensitive) della valuta per cui si richiede la quotazione. Nel caso di più valute il parametro sarà ripetuto. Se il parametro non viene passato, si intendono tutte le valute per cui è disponibile la quotazione nella data richiesta. Codici ISO inesistenti verranno scartati. Se tutti i codici ISO inseriti sono inesistenti, verrà restituita una lista vuota. Se il parametro è specificato in un formato errato, il servizio restituirà un messaggio di errore. currencyisocode Si No Codice ISO (case insensitive) della valuta "contro" cui si vuole la quotazione. Può valere EUR, USD, ITL. Se il parametro non è specificato, o è specificato un valore diverso da quelli validi, il servizio restituirà un messaggio di errore. lang No No Lingua in cui si desidera ottenere i dati: può valere it o en (case insensitive). Se il parametro non viene specificato, o viene valorizzato in modo errato, i risultati saranno forniti nella lingua di default. 5

Codici http di risposta: 200 OK 500 Internal Server Error 503 Service Unavailable 400 Bad Request 408 Request Timeout 404 Not Found Esempi di risposta: Content Type: application/json "resultsinfo": "totalrecords": 2, "rates": [ "country": "ALBANIA", "currency": "Lek", "isocode": "ALL", "uiccode": "047", "avgrate": "137.1730", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro", "exchangeconventioncode": "I", "year": 2016, "month": 9, "country": "ALGERIA", "currency": "Dinaro Algerino", "isocode": "DZD", "uiccode": "106", "avgrate": "122.6390", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro", "exchangeconventioncode": "I", "year": 2016, "month": 9 ] Content Type: text/csv Nome del file: cambi_medi_mensili_aaaamm.csv Paese,Valuta,Codice ISO,Codice UIC,Quotazione media,convenzione di cambio,anno,mese AFGHANISTAN,Afghani,AFN,115,75.4016,Quantita' di valuta estera per 1 Euro,2016,8 ALBANIA,Lek,ALL,047,136.547,Quantita' di valuta estera per 1 Euro,2016,8 ALGERIA,Dinaro Algerino,DZD,106,122.679,Quantita' di valuta estera per 1 Euro,2016,8 ANGOLA,Readjustado Kwanza,AOA,087,186.922,Quantita' di valuta estera per 1 Euro,2016,8 ANTIGUA E BARBUDA,Dollaro Caraibi Est,XCD,137,3.02717,Quantita' di valuta estera per 1 Euro,2016,8 6

Cambi Medi Annuali Fornisce i cambi medi annuali per uno specifico anno, contro Euro o contro Dollaro USA o contro Lira Italiana, di una o più valute richieste, che siano valide e per le quali sia disponibile la quotazione per il mese selezionato. E' possibile non specificare le valute desiderate, in tal caso il servizio restituisce tutte le valute quotate. Qualora, per l anno e le valute richieste, non esistano quotazioni, il servizio restituirà un elenco vuoto. GET /annualaveragerates?year=&[basecurrencyisocode=]&currencyisocode=&lang= Media type: È possibile avere il risultato nei seguenti formati: json, pdf, csv, Excel, a seconda del parametro dell header HTTP Accept: Accept: application/json Accept: application/pdf Accept: text/csv Accept: application/vnd.ms-excel Parametri di input: Nome Obbligatorio Ripetibile Descrizione year SI NO Anno per cui si richiede la quotazione. Deve essere un intero di 4 cifre nel formato YYYY. Se per l anno inserito non esistono dati il servizio restituirà un elenco vuoto. basecurrencyisocode NO SI Codice ISO (case insensitive) della valuta per cui si richiede la quotazione. Nel caso di più valute il parametro sarà ripetuto. Se il parametro non viene passato, si intendono tutte le valute per cui è disponibile la quotazione nella data richiesta. Codici ISO inesistenti verranno scartati. Se tutti i codici ISO inseriti sono inesistenti, verrà restituita una lista vuota. Se il parametro è specificato in un formato errato, il servizio restituirà un messaggio di errore. currencyisocode SI NO Codice ISO (case insensitive) della valuta "contro" cui si vuole la quotazione. Può valere EUR, USD, ITL. Se il parametro non è specificato, o è specificato un valore diverso da quelli validi, il servizio restituirà un messaggio di errore. lang NO NO Lingua in cui si desidera ottenere i dati: può valere it o en (case insensitive). Se il parametro non viene specificato, o viene valorizzato in modo errato, i risultati saranno forniti nella lingua di default. Codici http di risposta: 200 OK 500 Internal Server Error 503 Service Unavailable 400 Bad Request 408 Request Timeout 404 Not Found 7

Esempi di risposta: Content Type: application/json "resultsinfo": "totalrecords": 2, "rates":[ "country": "ALBANIA", "currency": "Lek", "isocode": "ALL", "uiccode": "047", "avgrate": "137.1730", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro", "exchangeconventioncode": "I", "year": 2016, "country": "ALGERIA", "currency": "Dinaro Algerino", "isocod": "DZD", "uiccod": "106", "avgrate": "122.6390", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro", "exchangeconventioncode": "I", "year": 2016 ] Content Type: text/csv Nome del file: cambi_medi_annuali_aaaa.csv Paese,Valuta,Codice ISO,Codice UIC,Quotazione media,convenzione di cambio,anno AFGHANISTAN,Afghani,AFN,115,75.074,Quantita' di valuta estera per 1 Euro,2016 ALBANIA,Lek,ALL,047,137.317,Quantita' di valuta estera per 1 Euro,2016 ALGERIA,Dinaro Algerino,DZD,106,121.097,Quantita' di valuta estera per 1 Euro,2016 ANGOLA,Readjustado Kwanza,AOA,087,182.079,Quantita' di valuta estera per 1 Euro,2016 ANTIGUA E BARBUDA,Dollaro Caraibi Est,XCD,137,2.98864,Quantita' di valuta estera per 1 Euro,2016 8

Cambi Giornalieri Serie Storiche Fornisce i cambi giornalieri di una valuta per un intervallo di date specificato. La valuta controvalore può essere Euro, Dollaro USA o Lira Italiana. In assenza di quotazioni per l'intervallo fornito, il servizio restituirà un elenco vuoto. La data di fine non può essere antecedente quella di inizio, altrimenti sarà restituito un messaggio di errore. E' consentita l'interrogazione su dati storici a partire dal 1918. GET /dailytimeseries?startdate=&enddate=&basecurrencyisocode=&currencyisocode =&lang= Media type: È possibile avere il risultato nei seguenti formati: json, pdf, csv, Excel, a seconda del parametro dell header HTTP Accept: Accept: application/json Accept: application/pdf Accept: text/csv Accept: application/vnd.ms-excel Parametri di input: Nome Obbligatorio Ripetibile Descrizione startdate Si No Data a partire da cui si richiedono le quotazioni. Viene interpretata relativamente al fuso orario dell Europa Centrale nel seguente formato: "yyyy-mm-dd - enddate Si No Data fino a cui si richiedono le quotazioni. Viene interpretata relativamente al fuso orario dell Europa Centrale nel seguente formato: "yyyy-mm-dd. basecurrencyisocode Si No Codice ISO (case insensitive) della valuta per cui si richiede la quotazione. Se il codice ISO inserito è inesistente verrà restituita una lista vuota. Se il parametro è specificato in un formato errato, il servizio restituirà un messaggio di errore. currencyisocode Si No Codice ISO (case insensitive) della valuta "contro" cui si vuole la quotazione. Può valere EUR, USD, ITL. Se il parametro non è specificato, o è specificato un valore diverso da quelli validi, il servizio restituirà un messaggio di errore. lang No No Lingua in cui si desidera ottenere i dati: può valere it o en (case insensitive). Se il parametro non viene specificato, o viene valorizzato in modo errato, i risultati saranno forniti nella lingua di default. 9

Codici http di risposta: 200 OK 500 Internal Server Error 503 Service Unavailable 400 Bad Request 408 Request Timeout 404 Not Found Esempi di risposta: Content Type: application/json "resultsinfo": "totalrecords": 2, "timezonereference":"le date sono riferite al fuso orario dell'europa Centrale", "currency": "Lek", "isocode": "ALL", "uiccode": "047", "exchangeconventioncode": "I", "rates": [ "referencedate": "2016-11-29", "avgrate": "137.1730", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro", "referencedate": "2016-11-30", "avgrate": "137.1820", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro" ] Content Type: text/csv Nome del file: <basecurrencyisocode>_serie_storica_giornaliera.csv Valuta,Codice ISO,Codice UIC,Quotazione,Convenzione di cambio,data di riferimento (CET) Lek,ALL,047,125.868534,Quantita' di valuta estera per 1 Dollaro,2015-05-04 Lek,ALL,047,126.011245,Quantita' di valuta estera per 1 Dollaro,2015-05-05 Lek,ALL,047,124.50872,Quantita' di valuta estera per 1 Dollaro,2015-05-06 Lek,ALL,047,124.33535,Quantita' di valuta estera per 1 Dollaro,2015-05-07 10

Cambi Medi Mensili Serie Storiche Fornisce i cambi medi mensili di una valuta per un intervallo di mesi specificato. La valuta controvalore può essere Euro, Dollaro USA o Lira Italiana. In assenza di quotazioni per l'intervallo fornito, il servizio restituirà un elenco vuoto. Il mese di inizio non può essere successivo a quello finale, altrimenti sarà restituito un messaggio di errore. GET /monthlytimeseries?startmonth=&startyear=&endmonth=&endyear=&basecurrenc yisocode=&currencyisocode=&lang= Media type: È possibile avere il risultato nei seguenti formati: json, pdf, csv, Excel, a seconda del parametro dell header HTTP Accept: Accept: application/json Accept: application/pdf Accept: text/csv Accept: application/vnd.ms-excel Parametri di input: Nome Obbligatorio Ripetibile Descrizione startmonth Si No Mese da cui si richiede la quotazione. Deve essere un intero compreso tra 1 e 12. startyear Si No Anno a partire dal quale si richiede la quotazione. Deve essere un intero di 4 cifre nel formato YYYY. endmonth Si No Mese fino a cui si richiede la quotazione. Deve essere un intero compreso tra 1 e 12. endyear Si No Anno fino al quale si richiede la quotazione. Deve essere un intero di 4 cifre nel formato YYYY. Se la coppia mese/anno di fine è precedente alla coppia mese/anno di inizio, il servizio restituirà un messaggio di errore. basecurrencyisocode Si No Codice ISO (case insensitive) della valuta per cui si richiede la quotazione. Se il codice ISO inserito è inesistente verrà restituita una lista vuota. Se il parametro è specificato in un formato errato, il servizio restituirà un messaggio di errore. currencyisocode Si No Codice ISO (case insensitive) della valuta "contro" cui si vuole la quotazione. Può valere EUR, USD, ITL. Se il parametro non è specificato, o è specificato un valore diverso da quelli validi, il servizio restituirà un messaggio di errore. lang No No Lingua in cui si desidera ottenere i dati: può valere it o en (case insensitive). Se il parametro non viene specificato, o viene valorizzato in modo errato, i risultati saranno forniti nella lingua di default. 11

Codici http di risposta: 200 OK 500 Internal Server Error 503 Service Unavailable 400 Bad Request 408 Request Timeout 404 Not Found Esempi di risposta: Content Type: application/json "resultsinfo": "totalrecords": 3, "currency": "Lek", "isocode": "ALL", "uiccode": "047", "exchangeconventioncode": "I", "rates": [ "referencedate": "2015-11", "avgrate": "128.6655", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro", "referencedate": "2015-12", "avgrate": "126.5039", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro", "referencedate": "2016-01", "avgrate": "127.2700", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro" ] Content Type: text/csv Nome del file: <basecurrencyisocode>_serie_storica_mensile.csv Valuta,Codice ISO,Codice UIC,Quotazione,Convenzione di cambio,data di riferimento Lek,ALL,047,128.6655,Quantita' di valuta estera per 1 Dollaro,2015-11 Lek,ALL,047,126.5039,Quantita' di valuta estera per 1 Dollaro,2015-12 Lek,ALL,047,127.2700,Quantita' di valuta estera per 1 Dollaro,2016-01 12

Cambi Medi Annuali Serie Storiche Fornisce i cambi medi annuali di una valuta, per un intervallo di anni specificato. La valuta controvalore può essere Euro, Dollaro USA o Lira Italiana. In assenza di quotazioni per l'intervallo fornito, il servizio restituirà un elenco vuoto. L anno di inizio non può essere successivo a quello finale, altrimenti sarà restituito un messaggio di errore. GET /annualtimeseries?startyear=&endyear=&basecurrencyisocode=&currencyisocode =&lang= Media type: È possibile avere il risultato nei seguenti formati: json, pdf, csv, Excel, a seconda del parametro dell header HTTP Accept: Accept: application/json Accept: application/pdf Accept: text/csv Accept: application/vnd.ms-excel Parametri di input: Nome Obbligatorio Ripetibile Descrizione startyear Si No Anno a partire dal quale si richiede la quotazione. Deve essere un intero di 4 cifre nel formato YYYY. endyear Si No Anno fino al quale si richiede la quotazione. Deve essere un intero di 4 cifre nel formato YYYY. Se l anno di fine è precedente all anno di inizio, il servizio restituirà un messaggio di errore. basecurrencyisocode Si No Codice ISO (case insensitive) della valuta per cui si richiede la quotazione. Se il codice ISO inserito è inesistente verrà restituita una lista vuota. Se il parametro è specificato in un formato errato, il servizio restituirà un messaggio di errore. currencyisocode Si No Codice ISO (case insensitive) della valuta "contro" cui si vuole la quotazione. Può valere EUR, USD, ITL. Se il parametro non è specificato, o è specificato un valore diverso da quelli validi, il servizio restituirà un messaggio di errore. lang No No Lingua in cui si desidera ottenere i dati: può valere it o en (case insensitive). Se il parametro non viene specificato, o viene valorizzato in modo errato, i risultati saranno forniti nella lingua di default. 13

Codici http di risposta: 200 OK 500 Internal Server Error 503 Service Unavailable 400 Bad Request 408 Request Timeout 404 Not Found Esempi di risposta: Content Type: application/json "resultsinfo": "totalrecords": 2, "currency": "Lek", "isocode": "ALL", "uiccode": "047", "exchangeconventioncode": "I", "rates": [ "referencedate": "2015", "avgrate": "128.6655", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro", "referencedate": "2016", "avgrate": "127.2700", "exchangeconvention": "Quantità di valuta estera per 1 Dollaro" ] Content Type: text/csv Nome del file: <basecurrencyisocode>_serie_storica_annuale.csv Valuta,Codice ISO,Codice UIC,Quotazione,Convenzione di cambio,data di riferimento Lek,ALL,047,125.9701,Quantita' di valuta estera per 1 Dollaro,2015 Lek,ALL,047,124.1039,Quantita' di valuta estera per 1 Dollaro,2016 14

Elenco Valute Restituisce l elenco di tutte le valute, comprese quelle non più quotate. GET /currencies?lang=lingua selezionata Media type: Accept: application/json Parametri di input: Nome Obbligatorio Ripetibile Descrizione lang No No Lingua in cui si desidera ottenere i dati: può valere it o en (case insensitive). Se il parametro non viene specificato, o viene valorizzato in modo errato, i risultati saranno forniti nella lingua di default. Codici http di risposta: 200 OK 500 Internal Server Error 503 Service Unavailable 400 Bad Request 408 Request Timeout 404 Not Found Esempi di risposta: Content Type: application/json "resultsinfo": "totalrecords": 2, "timezonereference": "Le date sono riferite al fuso orario dell'europa Centrale", "currencies": [ "countries": [ "currencyiso": "ADP", "country": "ANDORRA", "countryiso": "AD", "validitystartdate": "1999-02-01", "validityenddate": "2003-10-31" ], "isocode": "ADP", "name": "Peseta Andorra", "graph": false, "countries": [ "currencyiso": "AED", "country": "EMIRATI ARABI UNITI", 15

], "countryiso": null, "validitystartdate": "1981-06-15", "validityenddate": null ], "isocode": "AED", "name": "Dirham Emirati Arabi", "graph": false "countries": [ "currencyiso": "ZWN", "country": "ZIMBABWE", "countryiso": "ZW", "validitystartdate": "2006-08-01", "validityenddate": "2006-09-30" ], "isocode": "ZWN", "name": "Nuovo Dollaro Zimbabwe", "graph": false 16