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