Major improvements to our API ergonomics (August 2023)
In our ongoing mission to enhance your user experience, we're introducing changes to our APIs that will break compatibility. These will take effect on August 10, 2023, at 5 PM EST. We strongly recommend that you update to the latest version of our APIs or client libraries to support these changes.
We're making changes to our HTTP POST endpoints to improve our API standardization and address limitations with query parameters' maximum length. From now on, all HTTP POST endpoints will expect form-encoded data by default, replacing the previous support for both query parameters and form-encoded data.
The following updates will be implemented:
- The recommended method for the
timeseries.get_range
endpoint will transition toPOST
. We will still support theGET
version of the endpoint. - The primary method for the
symbology.resolve
endpoint will transition toPOST
. We will still support theGET
version of the endpoint. - Our client libraries will use the
POST
versions of endpoints where available. Thebatch.submit_job
endpoint will now require form-encoded data.
We're altering the following three metadata endpoints and their corresponding client library methods:
metadata.list_publishers metadata.list_fields metadata.list_unit_prices
These modifications will standardize parameter behavior and change the structure of responses from objects to ordered lists, resulting in more predictable and user-friendly endpoints.
The current metadata.json
file associated with batch jobs has a symbology section that duplicates the information found in the symbology.json
file. To minimize redundancy and reduce the size of batch downloads, we will be removing the symbology section of the metadata.json
file.
Note that the symbology.json
file contains the exact response you can obtain by querying the symbology.resolve
endpoint with the same parameters.
We understand that making these changes may require you to modify your code. However, we believe that these updates will improve your experience with our data, APIs, and services. If you have any questions or need assistance, please contact support.