Part of participating in an early-access beta is helping us iron out the kinks, and we’ve come across one in our URL scheme. In short, we need to rework our scheme a bit, and we wanted to give you a heads up.
In general, the URLs get a little simpler, and we’ve moved optional parts (like the version, and the product in the case of the extracts API) to query parameters.
Current URL examples:
https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets/1790_cPop
https://api.ipums.org/des/data_extract/agg/nhgis/vbeta/data_extracts
New URL examples (coming soon):
https://api.ipums.org/metadata/nhgis/datasets/1790_cPop?version=beta
https://api.ipums.org/extracts?product=nhgis&version=beta
Later this week we will be making the switch to the new scheme. At that time, access via the old APIs will no longer work. We will send another message to let you know the cutover has occurred, so that you can update your client code and test with the new ALI version. The documentation will also update to reflect the new URLs at the same time.
Thank you for your interest in the IPUMS API program!