Page History

...

CMR Environments Table

...

...

...

...

Operational (OPS)

...

https://api.echo.nasa.gov

Information on creating EDL tokens can be found at https://urs.

...

earthdata.nasa.gov

...

Acceptance Test (UAT)

...

https://api-test.echo.nasa.gov

...

https://beta.urs.eosdis.nasa.gov

...

Systems Integration Test (SIT)

...

https://testbed.echo.nasa.gov

...

https://alpha.urs.eosdis.nasa.gov

...

1. Depending on the environment you have chosen, the Base API URL may be different from the example.  If so, just replace the purple text with the correct Base API URL that you need. If you are imbedding the token REST messages into a programming language, create an HTTP message and place the same components from the curl example into either the message header or body. 

    

   UI Text Box
   curl -X POST --header "Content-Type: application/xml" -d "<token><username>sample_username</username><password>sample-password</password><client_id>client_name_of_your_choosing</client_id><user_ip_address>your_origin_ip_address</user_ip_address> <provider>PROV_ID</provider></token>" https://api.echo.nasa.gov/echo-rest/tokens

   The <provider> element in blue in the example above is only used if you are planning on working as or on behalf of a data provider (ingesting), client developers (searching) can leave it out. If you have special characters in your password, you will probably need to escape them using a backslash.

2. Another way using curl if you don't want to escape any characters, you can use the "file input" option to create a file that looks like the following:

   mytokengenerator.xml

    

   <token>   <username>sample_username</username>   <password>sample-password</password>   <client_id>client_name_of_your_choosing</client_id>   <user_ip_address>your_origin_ip_address</user_ip_address>   <provider>PROV_ID</provider> </token>

    

   Then, the full curl command looks a little bit different:

    

   curl -X POST --header "Content-Type: application/xml" -d @mytokengenerator.xml https://api-test.echo.nasa.gov/echo-rest/tokens

   Again, if using a programming language, just place the curl example parts into the correct http message header or body locations.

    

3. A sample response from the curl call is:

    

   <?xml version="1.0" encoding="UTF-8"?> <token>   <id>75E5CEBE-6BBB-2FB5-A613-0368A361D0B6</id>   <username>sample_username</username>   <client_id>client_name_of_your_choosing</client_id>   <user_ip_address>your_origin_ip_address</user_ip_address>   <provider>PROV_ID</provider> </token>

To delete a token execute the following curl command for the environment you have chosen. 

Depending on the environment you have chosen, the Base API URL may be different from the example.  If so, just replace the purple text with the correct Base API URL that you need. If you are imbedding the token REST messages into a programming language, create an HTTP message and place the same components from the curl example into either the message header or body. 

The return code should be a 204, otherwise an error has occurred.

...

/documentation/for_users/user_token