Common variables and list of queryable servers
In the following examples we have used the terms yourApiToken for the Dashboard generated API Key, SERVER to represent our database server to be queried and X to represent the check and device variables.
For example:
https://SERVER/api/?apikey=yourAPItoken&service=list_servers&siteid=X
The database server to query is dependent upon the territory your account is registered under. The current territories and respective URLs are:
| TERRITORY | URL |
|---|---|
|
Americas |
https://www.am.remote.management/ |
|
Asia |
https://wwwasia.system-monitor.com/ |
|
Australia |
https://www.system-monitor.com/ |
|
Europe |
https://wwweurope1.systemmonitor.eu.com/ |
|
France (FR) |
https://wwwfrance.systemmonitor.eu.com/ |
|
France1 |
https://wwwfrance1.systemmonitor.eu.com/ |
|
Germany |
https://wwwgermany1.systemmonitor.eu.com/ |
|
Ireland |
https://wwwireland.systemmonitor.eu.com/ |
|
Poland |
https://wwwpoland1.systemmonitor.eu.com/ |
|
United Kingdom |
https://www.systemmonitor.co.uk/ |
|
United States |
https://www.systemmonitor.us/ |
Based on the above, a United Kingdom user will use the URL https://www.systemmonitor.co.uk/ so their query would look like:
https://www.systemmonitor.co.uk/api/?apikey=1234567890abcdefg&service=list_servers&siteid=123
Determine API Server URL from Dashboard URL
If unsure of your Dashboard account's territory.
- Look at the URL used to access your Dashboard as this may include a region reference, or
- If the URL does not mention a region, for example a custom domain, append /dashboard to one of above URLs and attempt login to your Dashboard at the prompt. Based on the United Kingdom this would look like: https://www.systemmonitor.co.uk/dashboard
- Where problems are still experienced determining the region from a custom Dashboard URL. Open a command prompt or terminal on the device. Then perform an nslookup on the custom Dashboard URL:
nslookup dashboard.custom.domain
...
Non-authoritative answer:
Name: dashboard.systemmonitor.co.uk
...
In line with best security practices we would suggest querying the following database servers over HTTPS:
When requesting the API Key is sent from the Dashboard the respective server URL is including in the email.