December, 2024 — First release of this new interactive API documentation !
Frogcast
provides high-accuracy weather forecasts powered by advanced meteorological models. Our API makes
it easy to
integrate reliable, up-to-date weather data into your applications, whether you're building energy
management systems, agricultural tools, or any weather-dependent solution.
Built on REST principles, our API is designed to be simple to use and quick to implement.
Access customized weather forecasts for any location with flexible data formats tailored to your needs.
| Choose Your Endpoint | |
|---|---|
|
Single Location Weather Get weather forecasts for a specific point defined by latitude and longitude coordinates. |
Area-Based Forecasts Get weather data across a defined geographic area or polygon region. |
|
Available Forecast Fields Need to know which weather variables are available? |
|
The Frogcast API requires HTTPS and uses token-based authentication. Include your token in the authorization header with the 'Token' prefix as shown below:
headers = {'Authorization': 'Token
254b.....e098384..........xxx'}
| key | value |
|---|---|
| Authorization | Token ADD_TOKEN_HERE |
All API responses are returned in JSON format. Refer to each endpoint's documentation for detailed response structure.
Below are the HTTP status codes you may encounter when using the API:
| Result | StatusCode | Meaning |
|---|---|---|
| Success | 200 OK | Successful GET or PATCH request |
| 201 OK | Successful POST request An object was created |
|
| 202 OK | Successful DELETE request An object was deleted |
|
| 204 No Content | Successful GET request But empty response |
|
| Error | 400 Bad Request | The format or content of the request might be invalid (Please refer to the response body error message) |
| 401 Unauthorized | The request did not contain a valid Token (Please refer to authentication) |
|
| 403 Forbidden | Token valid, but not with the permission to make this API request | |
| 404 Not Found | Unvalid requested path | |
| 429 Too many requests | The request exceeds the rate limit of calls allowed for your subscription plan | |
| Failed | 500 Internal Server Error | Something unexpected went wrong during the request (if persisting, please contact us and include any error messages) |
| 502 Bad Gateway Error | Unexpected probably due to a server timeout. Try again after 30
seconds (if persisting, please contact us and include any error messages) |