Version 4 (modified by vegasm, 8 years ago) (diff) |
---|
Climate4Impact
The Downscaling Portal RESTful API is token based authentication. That means, the user has to include a token in every request.
Access the API
Climate4Impact has an existing account into the Downscaling Portal. With the credentials provided is very simple to authenticate and get the token.
curl -i -X POST -d username=your_username -d password=your_password http://meteo.unican.es/dp/rest/authenticate
Success
HTTP/1.1 201 Created Date: Mon, 24 Mar 2014 08:59:04 GMT token: your_token Content-Length: 0 Content-Type: text/plain
User Administration
The API allows the manager to create users who have the same experiments as him and this users will be attached to the manager. Thus, users can be added, listed and removed from the DPRA Climate4Impact service.
In order to clarify how to use the API quickly, we are going to follow an example step by step.
1. Create a new user
curl -i -H "Accept: application/json" -H "Content-type: application/json" -H "token: your_token" -X POST -d "{\"username\": \"pcmdi9.llnl.gov.openid.vegasm\", \"email\": \"vegasm@unican.es\", \"openID\": \"https://pcmdi9.llnl.gov/openid/vegasm\"}" http://meteo.unican.es/dp/rest/users
Response
HTTP/1.1 201 Created Date: Mon, 24 Mar 2014 09:08:17 GMT Content-Length: 0 Content-Type: text/plain
If the request generates an exception or something is missing, an error will be shown. Note: In some cases, it is possible that the character " has not to be escaped.
2. List users
curl -i -H "token: your_token" http://meteo.unican.es/dp/rest/users
Success
HTTP/1.1 200 OK Date: Mon, 24 Mar 2014 08:59:48 GMT Content-Type: application/json;charset=UTF-8 Transfer-Encoding: chunked {"responseCode":"success","message":"List of users retrieved","values":[{"username":"pcmdi9.llnl.gov.openid.vegasm","password":null,"email":"vegasm@unican.es","openID":"pcmdi9.llnl.gov.openid.vegasm"}]}
3.Remove user
curl -i -H "Accept: application/json" -H "Content-type: application/json" -H "token: your_token" -X DELETE http://meteo.unican.es/dp/rest/users/pcmdi9.llnl.gov.openid.vegasm
Success
HTTP/1.1 200 OK Date: Mon, 24 Mar 2014 09:00:59 GMT Content-Length: 0 Content-Type: text/plain