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

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

Postby flackdl » Tue May 29, 2018 11:08 am

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/?
flackdl
 
Posts: 2
Joined: Tue May 29, 2018 11:05 am

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

Postby podaac » Wed Jun 06, 2018 5:38 pm

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
podaac
Site Admin
 
Posts: 470
Joined: Mon Oct 22, 2012 4:00 pm

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

Postby flackdl » Thu Jun 07, 2018 5:20 am

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.
flackdl
 
Posts: 2
Joined: Tue May 29, 2018 11:05 am

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

Postby podaac » Mon Jun 11, 2018 4:17 pm

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
podaac
Site Admin
 
Posts: 470
Joined: Mon Oct 22, 2012 4:00 pm


Return to PO.DAAC Web Services