Account Information Calls ========================= /:username/account ------------------ Usage '''''' *GET* `/api/v1/admin/account` Return the name and email for the given user account. :query param: api_key *required* - the api key for your account to make the call with :query param: callback - wrap JSON response in an optional callback Status Codes ''''''''''''' :success 200: If successful a "200 OK" will be returned, with json body of message: done :error 403: if the api key is not valid or missing then this is an unauthorized request Example ''''''' :: requests.get('http://127.0.0.1:6543/api/v1/admin/account?api_key=12345...') >>> { "username": "admin", "name": null, "signup": null, "activated": true, "last_login": null, "email": "testing@dummy.com" } Usage ''''' *POST* `/api/v1/admin/account` Update the user's name or email address :query param: api_key *required* - the api key for your account to make the call with :query param: callback - wrap JSON response in an optional callback :post param: name - a new name for the user account :post param: email - a new email for the user account Status Codes '''''''''''''' :success 200: If successful a "200 OK" will be returned, with json body of message: done :error 403: if the api key is not valid or missing then this is an unauthorized request Example '''''''' :: requests.post('http://127.0.0.1:6543/api/v1/admin/account?api_key=12345...') >>> { "username": "admin", "name": null, "signup": null, "activated": true, "last_login": null, "email": "testing@dummy.com" } /:username/api_key ------------------ Usage ''''' *GET* `/api/v1/admin/api_key` Fetch the api key for the user from the system. We don't go waving the api key around so we have to ask for it on its own. Keep this safe. If it's exposed someone can get at about anything in the system for that user. I know it's strange to require the api key to get the api key, but hey, you tell me how to fix it. :query param: api_key *required* - the api key for your account to make the call with :query param: callback - wrap JSON response in an optional callback Status Codes ''''''''''''' :success 200: If successful a "200 OK" will be returned, with json body of message: done :error 403: if the api key is not valid or missing then this is an unauthorized request Example '''''''' :: requests.post('http://127.0.0.1:6543/api/v1/admin/api_key?api_key=12345...') >>> { "username": "someuser", "api_key": "12345..." } /:username/api_key ------------------ Usage ''''' *POST* `/api/v1/admin/reset_api_key` Request a brand new API key. The old API key will be invalidated. A new key will be generated and tied to your account. Please do not forget to update the API key in the browser extensions and other places where the API is used. :post param: api_key *required* - the api key for your account to make the call with :post param: username *required* - the username whose api key has to be reset Status Codes ''''''''''''' :success 200: If successful a "200 OK" will be returned, with json body of message: done :error 403: If the api key is not valid or missing then this is an unauthorized request Example '''''''' :: requests.post('http://127.0.0.1:6543/api/v1/admin/api_key?api_key=12345...') >>> { "api_key": "98765...", "message": "API key was..." } /:username/password ------------------- Usage ''''' *POST* `/api/v1/admin/account/password` Change the user's password to the new value provided. Note that the current password is required to perform the step. :query param: api_key *required* - the api key for your account to make the call with :query param: callback - wrap JSON response in an optional callback :post param: current_password *required* - the current password string from the user :post param: new_password *required* - the string to change the password to Status Codes '''''''''''' :success 200: If successful a "200 OK" will be returned, with json body of message: done :error 403: if the api key is not valid or missing then this is an unauthorized request :error 406: if the new password is not of acceptable strength. We're not letting 2 char passwords to be set, sorry. Example ''''''' :: requests.post('http://127.0.0.1:6543/api/v1/admin/password?api_key=12345...') >>> { "username": "someuser", "api_key": "12345..." }