User¶
Retrieve profile¶
Example¶
curl -X GET https://api.ona.io/api/v1/user
Response¶
{
"api_token": "76121138a080c5ae94f318a8b9be91e7ebebb484",
"temp_token": "0668993ad2f9fa6a0bff58389996cf85f11894ca"
"city": "Nairobi",
"country": "Kenya",
"gravatar": "avatar.png",
"name": "Demo User",
"email": "demo@user.com",
"organization": "",
"require_auth": false,
"twitter": "",
"url": "http://api.ona.io/api/v1/profiles/demo",
"user": "http://api.ona.io/api/v1/users/demo",
"username": "demo",
"website": "",
}
Get projects that the authenticating user has starred¶
GET /api/v1/user/{username}
/starred
Request password reset¶
POST /api/v1/user/reset
Sends an email to the user’s email with a url that redirects to a reset password form on the API consumer’s website.
email
andreset_url
are expected in the POST payloademail_subject
is optional.Expected reset_url format is
reset_url=https:/domain/path/to/reset/form
.Example of reset url sent to user’s email is
http://mydomain.com/reset_form?uid=Mg&token=2f3f334g3r3434&username=dXNlcg==
.uid
is the usersunique key
which is a base64 encoded integer value that can be used to access the users info at/api/v1/users/<pk>
or/api/v1/profiles/<pk>
. You can retrieve the integer value injavascript
using thewindow.atob();
function.username
is a base64 encoded value of the user’s usernametoken
is a onetime use token that allows password reset
Example¶
curl -X POST -d email=demouser@mail.com -d reset\_url=http://example-url.com/reset https://api.ona.io/api/v1/user/reset -d email_subject="Reset password requested"
Response¶
HTTP 204 OK
Reset user password¶
POST /api/v1/user/reset
Resets user’s password
uid
,token
andnew_password
are expected in the POST payload.minimum password length is 4 characters
Example¶
curl -X POST -d uid=Mg -d token=qndoi209jf02n4 -d new\_password=usernewpass https://api.ona.io/api/v1/user/reset
Response¶
{
"username": "demouser"
}
Expire temporary token¶
DELETE /api/v1/user/expire
Expires the temporary token
Example¶
curl -X DELETE https://api.ona.io/api/v1/user/expire
Response¶
HTTP 204 OK