Sdmx9 webservices
Download as PPTX, PDF0 likes250 views
This document discusses SDMX web services and REST APIs. It defines key terms like web service, endpoint, and network. It then explains that an SDMX web service is an endpoint published on a server that is reachable over a network. It provides examples of querying structural metadata and data using URIs. It shows how to request code lists, data structures, dataflows, and time-series data. The specification and benefits of open data and APIs for statistics are also briefly covered.
Sdmx9 webservices
- 1. SDMX 9 Webservices UN/FAO - Erik van Ingen Abuja, Nigeria, 13-14 May 2015
- 2. What on earth is a webservice?
- 3. First some terms Access Point or End Point The application or endpoint on the internet where the data or program is accessed Machine An internet browser or any other sorts of computer program Human As opposed to a machine, a human being Network Computer network, internet
- 5. IMF
- 6. SDMX webservice is an endpoint, published on a server (machine), reachable over the network
- 7. NBS State 1 State 2 State n LGA 1 LGA 2 LGA n
- 8. SDMX Client IMFsdmx client We will talk more about the SDMX client in another presentation
- 9. 2 flavors SOAP & REST This course will not discuss SOAP and continuous with REST
- 10. SDMX RESTful APi • This SDMX API is based on the REST principles, as described below • In REST, specific information is known as “Resource”. In SDMX, specific resources would be, for example, code lists, concept schemes, data structure definitions, dataflows, etc. • Each resource is addressable via a global identifier (i.e.: a URI).
- 11. Structural Metadata Queries The following resources are defined: • datastructure • conceptscheme • codelist • Agencyscheme • Etc.
- 13. Example 2 version 1.0 of the DSD with id ECB_EXR1 maintained by the ECB, as well as the code lists and the concepts used in the DSD http://ws-entry- point/datastructure/ECB/ECB_EXR1/1.0?referen ces=children
- 14. Example 3 latest version in production of the DSD with id ECB_EXR1 maintained by the 336 ECB, without the code lists and concepts of the DSD http://ws-entry- point/datastructure/ECB/ECB_EXR1
- 15. Example 4 all DSDs maintained by the ECB, as well as the dataflows using these DSDs http://ws-entry- point/datastructure/ECB?references=dataflow
- 16. Example 5 latest version in production of all code lists maintained by all maintenance agencies, but without the codes http://ws-entry-point/codelist?detail=allstubs
- 17. Example 6 as stubs, the latest version in production of all maintainable artefacts maintained 345 by the ECB http://ws-entry- point/structure/ECB?detail=allstubs
- 18. Data Queries http://ws-entry-point/data/ This could be: www.nigerianstat.gov.ng/sdmx/data/etc
- 19. Example 1 data for the series M.USD.EUR.SP00.A supplied by the ECB for the 375 ECB_EXR1_WEB dataflow http://ws-entry- point/data/ECB_EXR1_WEB/M.USD.EUR.SP00.A/ECB In this example, the assumption is made that the dataflow id (ECB_EXR1_WEB) is sufficient to uniquely identify the dataflow, and the data provider id (ECB) is sufficient to uniquely identify the data provider
- 20. Example 2 data, provided by the ECB for the ECB_EXR1_WEB dataflow, for the supplied series keys, using wildcarding for the second dimension http://ws-entry- point/data/ECB,ECB_EXR1_WEB,latest/M..EUR.SP00.A/EC B In this example, the full reference to the dataflow is supplied (ECB as maintenance agency, ECB_EXR1_WEB as dataflow id and latest for the version)
- 21. Example 3 updates and revisions for the data matching the supplied series keys, using the OR operator for the second dimension, and using percent encoding for the updatedAfter Date http://ws-entry-389 point/Data/ECB_EXR1_WEB/M.USD+GBP+JPY.E UR.SP00.A?updatedAfter=2390 009-05-15T14 %3A 15 %3A 00%2B01%3A00
- 22. Example 4 data matching the supplied series key and restricting the start and end dates http://ws-entry-394 point/data/ECB_EXR1_WEB/D.USD.EUR.SP00.A? startPeriod=2009-05-395 01&endPeriod=2009- 05-31
- 24. open data & api http://en.wikipedia.org/wiki/Open_data http://en.wikipedia.org/wiki/Web_API
- 25. SDMX & open data & api What does open data mean for the statistical data community? Why are the technology trendsetters (Google, Facebook, Twitter, Amazon) publishing APIs? SDMX REST API is a way to open your statistical data, by publishing a formal API
- 26. thank you