Page 1 of 1

JSON API (podaac.jpl.nasa.gov/api/)

PostPosted: Tue May 29, 2018 11:08 am
by flackdl
I noticed the "Granule (File) Listing" page is using a json api under the hood (via javascript) that I can't seem to find documentation for.

Dataset:
https://podaac.jpl.nasa.gov/dataset/SMA ... 0Winds:*2*

JSON API:
https://podaac.jpl.nasa.gov/api/granule ... setId=5832

How does JSON API, https://podaac.jpl.nasa.gov/api/, differ from the Web Services one, https://podaac.jpl.nasa.gov/ws/?

Re: JSON API (podaac.jpl.nasa.gov/api/)

PostPosted: Wed Jun 06, 2018 5:38 pm
by podaac
Greetings,

Thank you for your inquiry.


The JSON API used for the "Granule (File) Listing" page is a custom API intended for internal use by the Web Portal only. We don't recommend external users using this internal API.

We highly recommend that our users go through our public Web Services API to search for datasets & granules. The 'https://podaac.jpl.nasa.gov/ws' URL is our official public Web Services API for external users.

The PO.DAAC Web Services use a Representational State Transfer (REST) model with calls issued over a Hypertext Transfer Protocol (HTTP) connection. On receipt of a request message, our services return the response in either an Extensible Markup Language (XML) structure or, optionally, a JavaScript Object Notation (JSON) format.


If you are interested in Python toolkit for interacting with our Web Services, check out the 'podaacpy' video tutorial.

For other Data Recipes on PO.DAAC Data Access and Services, please visit Data Recipes Forum


Respectfully,
PO.DAAC Tools & Services Team

Re: JSON API (podaac.jpl.nasa.gov/api/)

PostPosted: Thu Jun 07, 2018 5:20 am
by flackdl
Thanks for the reply. I was interested in that internal api because the main Web Services API talks about supporting JSON responses but it appears only some of the endpoints support it. Is that accurate?

For instance, searching a dataset (https://podaac.jpl.nasa.gov/ws/search/d ... index.html) does not appear to support JSON responses.

However, the granule subset endpoint (https://podaac.jpl.nasa.gov/ws/subset/g ... index.html) does return json responses.

I guess my question is whether you can consistently receive json responses from all endpoints or not.

Thanks for your support.

Re: JSON API (podaac.jpl.nasa.gov/api/)

PostPosted: Mon Jun 11, 2018 4:17 pm
by podaac
flackdl wrote:Thanks for the reply. I was interested in that internal api because the main Web Services API talks about supporting JSON responses but it appears only some of the endpoints support it. Is that accurate?

For instance, searching a dataset (https://podaac.jpl.nasa.gov/ws/search/d ... index.html) does not appear to support JSON responses.

However, the granule subset endpoint (https://podaac.jpl.nasa.gov/ws/subset/g ... index.html) does return json responses.

I guess my question is whether you can consistently receive json responses from all endpoints or not.

Thanks for your support.


Unfortunately, we do not support JSON format response for a dataset search at this time. Thank you for your feedback. We may be able to provide that capability in near future.


Respectfully,
PO.DAAC Tools & Services Team