We are glad to announce a significative DBnomics update. A new website and a new web API have been deployed. The previous website and web API have been kept under the new domains https://legacy.nomics.world/ and https://api.legacy.nomics.world/.
We started working on the new version since May 2017.
We deployed it from the beginning under the domains https://next.nomics.world/ and https://api.next.nomics.world/ following continuous delivery.
As a consequence some people are already familiar with the new version of DBnomics.
The new website offers various improvements:
- search for datasets or series by keywords, thanks to the full-text search engine (i.e. https://db.nomics.world/?q=unemployment)
- in a dataset, drill down to a small number of series by using faceted search (i.e. ECB/SPF)
Upgrading from “legacy” web API
If you wrote a script (i.e. in Python or R) calling DBnomics API with URLs starting with
https://api.db.nomics.world/api/v1/, it will continue to work because we have setup a redirection to
https://api.legacy.nomics.world/api/v1/, keeping the whole URL.
https://api.db.nomics.world/api/v1/json/series/ameco-nptd-ea19-1-0-0-0-nptd is redirected to
Note: you may check that your library follows redirections automatically. This is the case for Python requests for example.
As explained below in the “Next steps” section, we will shutdown the legacy web API in 3 months. You may want to upgrade your script to use the new DBnomics web API.
Note: the JSON responses of the new web API are different than the legacy. Besides upgrading the URLs, you have to upgrade your source code processing responses.
The new DBnomics web API outputs JSON data. SDMX format (based on XML) is not supported anymore. If you were using it, you will have to upgrade your source code to use JSON data instead.
Upgrading from “next” web API
If you’re already using “next” URLs, just replace
Rolling releases of the web API
The web API is currently at version 21. We plan to keep 2 versions of the web API at the same time.
/v22will be released
/v21will continue to exist but will be deprecated
/v23will be released
/v22will continue to exist but will be deprecated
- and so on…
/ redirects to the latest API version (i.e.
/v21) and explicit calls to
/vN will serve older versions. This avoids clients to break!
At each major version release, we will post an announcement on DBnomics forum in the Community category.
In 1 month, on 2018-10-20, we will stop updating data in the legacy website.
We would like to thank people who helped us design the new product.
If you have any question please reply to this topic. We will do the maximum to help you with this new release.