Post on 02-Jan-2016
SDMX Web Services
the JSON version
Sami Airo & Gerard Salou
Rubric
www.ecb.europa.eu
Agenda
• SDMX Web Services
• SDMX JSON
• Implementation: the ECB Tablet App
2
Rubric
www.ecb.europa.eu
SDMX WEB SERVICES
3
Rubric
www.ecb.europa.eu4
SDMX RESTful web services Basic principles:
• Based on REST principles:– Resource addressability (URI)– Resource manipulation (HTTP GET, POST, etc)– Resource representation (HTTP content negotiation)
• Distinction between:– Parameters that identify a resource (in the path)– Parameters that further refine the results (in the query string)
Rubric
www.ecb.europa.eu5
Structural metadata queries
• Retrieve any maintainable SDMX artefact=> Data and metadata structure definitions, category schemes and
categorisations, concept schemes, codelists and hierarchical codelists, organisation schemes, dataflow definitions, reporting taxonomies, provision agreements, structure sets, processes and constraints.
• Resolve direct references
• Retrieve minimal version of the artefact
Rubric
www.ecb.europa.eu6
Data queries
• Retrieve statistical data and metadata using keys (with wildcarding and OR operator), flows and providers.
• Refine queries, using time information (start period and end period).
• Retrieve updates and revisions only.
• Retrieve how data have changed over time.
• Retrieve various amount of detail.
Rubric
www.ecb.europa.eu
Schema queries
• XML schemas are used to validate XML data files.
• Possibility to set a validation “context”(like DSD or dataflow).
• Possibility to return the schema for the data currently in production without the need to know the version number.
7
Rubric
www.ecb.europa.eu8
Resource representation & HTTP content negotiation• Selection of the appropriate format using HTTP Content Negotiation
(Accept HTTP Header)
• Supported formats:– 2 flavours of SDMX-ML– SDMX-JSON– 2 flavours of CSV
• Compression
• Caching mechanism
Rubric
www.ecb.europa.eu
SDMX JSON
9
Rubric
www.ecb.europa.eu
AN APPLICATION:THE ECB TABLET APP
10
Rubric
www.ecb.europa.eu11
Rubric
www.ecb.europa.eu12
Rubric
www.ecb.europa.eu13
Rubric
www.ecb.europa.eu14
Rubric
www.ecb.europa.eu15
Rubric
www.ecb.europa.eu16
Rubric
www.ecb.europa.eu17
Rubric
www.ecb.europa.eu18
Rubric
www.ecb.europa.eu
THANK YOU!
19