1. Catalog REST for data providers ECHO Technical Interchange 04/30/13 3:15pm EST Doug Newman

2. Rationale Troubleshooting your data issues Managing your data Surgical fixes (REST providers only) On a provider, dataset and granule level

3. Tools to follow along Firefox Rest Client add-on http://restclient.net/ Chrome Advanced Rest Client add-on https://chrome.google.com/webstore/detail/advanced-rest-client IE – on your own Command line curl

4. Things you need to know HTTP REST (GET, POST, PUT, DELETE) XML ECHO ingest

5. The key to the kingdom (tokens) Request: POST https://api.echo.nasa.gov/echo-rest/tokens Body: ops urs username ops urs password your id your IP address Headers: Content-Type: application/xml Response: XXDD5E8D-039C-6386-FF50-D8DC24009051 ops urs username your id your IP address

6. Your provider Requests: GET https://api.echo.nasa.gov/catalog-rest/providers/ PUT https://api.echo.nasa.gov/catalog-rest/providers/ Headers: Accept: application/xml Content-Type: application/xml Echo-Token: your token value

7. Your datasets Requests: GET https://api.echo.nasa.gov/catalog-rest/providers/ /datasets/ PUT https://api.echo.nasa.gov/catalog-rest/providers/ /datasets/ A note about encoding: you may have to url-encode your dataset id, etc (not with FF Rest Client) Headers: Accept: application/xml Content-Type: application/xml Echo-Token: your token value

8. Your granules Requests: GET https://api.echo.nasa.gov/catalog-rest/providers/ /granules/ PUT https://api.echo.nasa.gov/catalog-rest/providers/ /granules/ DELETE https://api.echo.nasa.gov/catalog-rest/providers/ /granules/ A note about encoding: you may have to url-encode your granule id etc (not with FF Rest Client) Headers: Accept: application/xml Content-Type: application/xml Echo-Token: your token value

9. Visibility to your users https://api.echo.nasa.gov/catalog-rest/echo_catalog/ datasets.xml datasets.xml?dataset_id=my_dataset_id datasets.xml?provider=my_provider datasets.xml?provider=my_provider&page_size=20&page_num=2 granules.xml granules.xml?granule_ur=my_granule_ur granules.xml?dataset_id=my_dataset_id granules.xml?dataset_id=my_dataset_id&page_size=20&page_num=2 https://api.echo.nasa.gov/catalog-rest/catalog-docs/index.html

10. With great power… I can do that? YES

11. Questions?