Retrieving multiple versions of a keyword through the KMS API
-
- Posts: 3
- Joined: Tue Nov 15, 2022 3:53 pm America/New_York
Retrieving multiple versions of a keyword through the KMS API
I am wondering if there is a way to view each version of a keyword via the API.
I see that the Concepts route in the API supports a `version` query param (https://wiki.earthdata.nasa.gov/display/ED/KMS+User%27s+Guide#KMSUser'sGuide-2.2ConceptResource). I would expect this to return the properties of the keyword for the provided version, but it seems that setting that query param only modifies the value of `<keywordVersion>` in the response, while the rest of the data stays the same, regardless of which version is specified.
For example, "NASA/JPL/EMIT > Earth Surface Mineral Dust Source Investigation, Jet Propulsion Laboratory, NASA" was updated in version 14.7, but if I request version 14.6 (https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?format=xml&version=14.6), the response body is the same as if I specify 14.7 or don't specify a version.
Am I providing the wrong value to `version` or is this the expected behavior?
Thanks!
Ed
I see that the Concepts route in the API supports a `version` query param (https://wiki.earthdata.nasa.gov/display/ED/KMS+User%27s+Guide#KMSUser'sGuide-2.2ConceptResource). I would expect this to return the properties of the keyword for the provided version, but it seems that setting that query param only modifies the value of `<keywordVersion>` in the response, while the rest of the data stays the same, regardless of which version is specified.
For example, "NASA/JPL/EMIT > Earth Surface Mineral Dust Source Investigation, Jet Propulsion Laboratory, NASA" was updated in version 14.7, but if I request version 14.6 (https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?format=xml&version=14.6), the response body is the same as if I specify 14.7 or don't specify a version.
Am I providing the wrong value to `version` or is this the expected behavior?
Thanks!
Ed
Tags:
-
- User Services
- Posts: 195
- Joined: Tue Dec 03, 2019 3:31 pm America/New_York
- Been thanked: 5 times
Re: Retrieving multiple versions of a keyword through the KMS API
Hi Ed, I think the issue was with the keyword cache. I cleared the cache and I can now see the difference between the two keywords. The cache helps make the query faster, but sometimes it doesn't clear and you have to do it manually.
https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?version=14.6&cache=clear&format=json
https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?version=14.7&cache=clear&format=json
Scott Ritz
https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?version=14.6&cache=clear&format=json
https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?version=14.7&cache=clear&format=json
Scott Ritz
-
- Posts: 3
- Joined: Tue Nov 15, 2022 3:53 pm America/New_York
Re: Retrieving multiple versions of a keyword through the KMS API
Thanks very much, Scott. That looks like it's working.
I was also curious about retrieving a list of the keyword changes published with a given Concept Version. I didn't see an endpoint for that in the docs, but I'm wondering if there's a param I can pass to the Concept Version endpoint or some other way of retrieving it.
Thanks again,
Ed
I was also curious about retrieving a list of the keyword changes published with a given Concept Version. I didn't see an endpoint for that in the docs, but I'm wondering if there's a param I can pass to the Concept Version endpoint or some other way of retrieving it.
Thanks again,
Ed
-
- User Services
- Posts: 195
- Joined: Tue Dec 03, 2019 3:31 pm America/New_York
- Been thanked: 5 times
Re: Retrieving multiple versions of a keyword through the KMS API
Hi Ed, unfortunately there isn't an endpoint that returns what changed for a given Concept Version. We publish manually created keyword change announcements for each release at https://wiki.earthdata.nasa.gov/display/ED/Keyword+Release+Announcements
Scott
Scott
-
- Posts: 3
- Joined: Tue Nov 15, 2022 3:53 pm America/New_York
Re: Retrieving multiple versions of a keyword through the KMS API
Ok, thanks very much, Scott. I appreciate the quick responses.
Ed
Ed