Authentication for the API system is performed using standard HTTP authentication. When sending a query via the API using a webbrowser a message box will appear, requiring the account holder's username and password to be entered in order to continue.
Authentication details can also be sent via the URL by inserting the username and password separated by a colon and suffixed with @, before the hostname in the query URL.
NOTE: Remember that data supplied via URL's should be correctly URL encoded.
NOTE: Microsoft Internet Explorer has disabled the ability to supply usernames and passwords via the URL in the latest versions.
This will prevent testing this function with Internet Explorer.
An example of checking the account status showing the URL authentication method:
Any authentication failure will return a HTTP 401: Unauthorized.
< Account status |
Error codes >