Here are some common questions we receive regarding the WeatherLink v2 API.
- What is a Station ID?
- Is a Station ID the same as the Device ID or DID?
- How do I find my Station ID?
- Why does the API tell me “API call timestamp parameter t is stale”?
What is a Station ID?
The WeatherLink v2 API accepts 2 kinds of identifiers as the Station ID parameter in API requests. The first is a unique integer ID that can be retrieved from an API call to the /stations
API endpoint. The second kind of identifier allowed is a UUID that can also be retrieved using an API call to the /stations
endpoint. However, the UUID value can also be retrieved from the WeatherLink.com web site. It can be found in the URL shown in your browser address bar when viewing the particular station in question.
Is a Station ID the same as the Device ID or DID?
The 2 forms of Station ID the WeatherLink v2 API accepts are not the same as the Device ID or DID.
In the past a single Device ID could be used to easily identify a weather station connected to a WeatherLink IP or Vantage Connect. However, in the world of EnviroMonitor every Node and Gateway are assigned Device ID numbers as well. Therefore, Device ID is no longer a nice and simple option to serve as the unique and single ID for the entirety of a weather station.
How do I find my Station ID?
You can get the Station IDs for the weather stations you have access to by calling the /stations
API endpoint. This is discussed on the API Use Cases page. Alternatively, if you wish to use the UUID form of Station ID you can retrieve it from the URL shown in your browser address bar when viewing the particular station in question on WeatherLink.com.
Why does the API tell me “API call timestamp parameter t is stale”?
This message appears when you trigger a legacy authentication system that is no longer the primary way to authenticate your API calls to the WeatherLink v2 API. To fix this please be sure to include your API secret as a request header named X-Api-Secret (the header name is case-insensitive). More information can be found on the preferred authentication requirements at Authentication.