DBnomics API v22 released

Community
4

Having experimented a bit further I have two comments on the v22 APIs.

  1. The new path /datasets/{provider_code} (“Respond datasets of a provider.”)

This could do with fuller documentation. The “limit” and “offset” parameters are
not mentioned under apidocs/v22, and it’s perhaps surprising that the default
limit is 10 (given that some providers have thousands of datasets).

  1. The element “observations_attributes” which appears under series.docs
    in some cases.

This element is represented as an array of arrays. For example under
IMF/CPI/Q.BE.PCPIT_IX we have:

"observations_attributes" : [["REFERENCE_PERIOD", "2013A"]]

Making the inner element here an array suggests that “REFERENCE_PERIOD”
and “2013A” have the same logical status, but I guess it’s actually a matter of
key plus value, in which case it would be more transparent to represent the
inner element(s) as JSON object(s):

"observations_attributes" : [{"REFERENCE_PERIOD" : "2013A"}]