Geocaching Australia API: Login
Login and return cookie.
Geocaching Australia API call: https://geocaching.com.au/api/services/login/login/
Parameters not explicitly detailed will be silently ignored if passed.
Username and password are case sensitive.
Geocaching Australia uses a concept of username which is used to log into the site and cachername which is what the geocacher is known as. These two values may be different.
Once a cookie has been returned, the cachername will also be returned. The cachername is the name that should be used to identify the geocacher for log, image and geocache ownership.
Calling the method
This method may only be called using a POST method. Any attempt to call via a GET method will return an error. The use of a POST method ensures that the username and password are not passed by URL.
Field | Definition | Description |
username | Mandatory | The username used to log into the website. Username is case sensitive. |
password | Mandatory | The password used to log into the website. Password is case sensitive. |
Validation
This form may only be submitted by a POST method.
https://geocaching.com.au/api/services/login/login/
https://geocaching.com.au/api/services/login/login/
Invalid username password combination. Usernames and passwords are case sensitive.
https://geocaching.com.au/api/services/login/login/
https://geocaching.com.au/api/services/login/login/
Data Fields Returned
If the login is successful a dictionary (array) named 'data' will be returned with the following elements.
Field | Description |
success | Boolean true if login is successful. |
message | You have logged in successfully. |
cachername | The cachername for the logged in user. |