### Get Solar Panels URL Example

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

An example of the URL used to fetch solar panel data for a given location. This includes a sample `location_id`.

```text
https://api.openweathermap.org/energy/2.0/location/F01E165B-22F3-4591-89D4-F238E92F6885?appid={API key}
```

--------------------------------

### Example API Call by City ID (No Date Specified)

Source: https://openweathermap.org/api/history?collection=historical

Example API call using a city ID. If start and end/cnt are not specified, default historical data may be returned. Ensure you have the correct city ID and API key.

```text
https://history.openweathermap.org/data/2.5/history/city?id=2885679&type=hour&appid={API key}
```

--------------------------------

### API Call with API Key

Source: https://openweathermap.org/faq

This example shows how to include your API key as a parameter in a GET request to OpenWeather's API.

```http
api.openweathermap.org/data/2.5/weather?id=524901&appid=YOUR_API_KEY
```

--------------------------------

### Delete Solar Panel URL Example

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

An example of the URL for deleting a solar panel, demonstrating the use of a specific `panel_id`.

```text
https://api.openweathermap.org/energy/2.0/panel/F01E165B-22F3-4591-89D4-F238E92F6885?appid={API key}
```

--------------------------------

### Example API Call

Source: https://openweathermap.org/api/one-call-4

An example of how to construct the API request URL for a specific alert ID. Ensure you replace `{API key}` with your actual API key.

```text
https://api.openweathermap.org/data/4.0/onecall/alert/8B46C632-DCA7-44D7-8BDF-02445621BAFF?appid={API key}
```

--------------------------------

### 7-Day Forecast by City Name (Metric Units)

Source: https://openweathermap.org/api/forecast16?collection=current_forecast

This example demonstrates how to call the API to get a 7-day weather forecast for a city, specifically requesting data in metric units. Remember to replace the placeholders.

```api
api.openweathermap.org/data/2.5/forecast/daily?q={city name}&cnt=7&appid={API key}&units=metric
```

--------------------------------

### API Call Example with API Key

Source: https://openweathermap.org/appid

This example demonstrates how to make an API call to retrieve weather data, including the required API key.

```APIDOC
## GET api.openweathermap.org/data/2.5/forecast

### Description
This endpoint retrieves weather forecast data for a specified location using your unique API key.

### Method
GET

### Endpoint
`http://api.openweathermap.org/data/2.5/forecast?id=524901&appid={API key}`

### Parameters
#### Query Parameters
- **appid** (string) - Required - Your unique API key. This key is essential for authenticating your request and accessing the weather data. You can find your API key on your account page under the "API key" tab.

### Request Example
```text
http://api.openweathermap.org/data/2.5/forecast?id=524901&appid=YOUR_API_KEY
```

### Response
#### Success Response (200)
- The response will contain weather forecast data for the specified location. The exact structure of the response depends on the specific data points requested and the API version being used.

#### Response Example
```json
{
  "cod": "200",
  "message": 0,
  "cnt": 40,
  "list": [
    {
      "dt": 1661875200,
      "main": {
        "temp": 298.48,
        "feels_like": 298.74,
        "temp_min": 297.56,
        "temp_max": 300.05,
        "pressure": 1015,
        "sea_level": 1015,
        "grnd_level": 933,
        "humidity": 69,
        "temp_kf": 2.49
      },
      "weather": [
        {
          "id": 800,
          "main": "Clear",
          "description": "clear sky",
          "icon": "01d"
        }
      ],
      "clouds": {
        "all": 0
      },
      "wind": {
        "speed": 3.65,
        "deg": 349,
        "gust": 6.07
      },
      "visibility": 10000,
      "pop": 0.21,
      "sys": {
        "pod": "d"
      },
      "dt_txt": "2022-08-30 12:00:00"
    }
  ],
  "city": {
    "id": 524901,
    "name": "Moscow",
    "coord": {
      "lat": 55.7522,
      "lon": 37.6156
    },
    "country": "RU",
    "population": 1000000,
    "timezone": 10800,
    "sunrise": 1661834104,
    "sunset": 1661887904
  }
}
```
```

--------------------------------

### Temperature Map Layer Example

Source: https://openweathermap.org/api/weathermaps

Example of how to request a temperature weather map layer. This layer displays temperature variations worldwide.

```text
layer : temp_new
area : worldwide
```

--------------------------------

### API Response Example (City Name)

Source: https://openweathermap.org/api/history?collection=historical

Example URL for fetching historical data by city name. Replace '{API key}' with your actual API key.

```text
https://history.openweathermap.org/data/2.5/history/city?q=Munchen,DE&appid={API key}
```

--------------------------------

### Hourly Forecast API Call Example by ZIP Code

Source: https://openweathermap.org/api/hourly-forecast

An example of an API call to get hourly forecast data using a ZIP code and country code.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?zip=94040,us&appid={API key}
```

--------------------------------

### Solar Data API URL Example

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

A concrete example of a URL for requesting solar data, specifying location, date, and interval.

```text
https://api.openweathermap.org/energy/2.0/location/018aa7aa-3d5f-85a2-91ee-b1b53c3e98a4/interval_data?date=2021-05-01&interval=1h&appid={API key}
```

--------------------------------

### Example CSV Bulk Download Link

Source: https://openweathermap.org/api/bulk

This example shows how to construct a download link for a bulk file in CSV format. Note the change from '.json.gz' to '.csv.gz' in the file name.

```text
https://bulk.openweathermap.org/snapshot/weather_zip_us.csv.gz?appid={API key}
```

--------------------------------

### API Call Example (Forecast)

Source: https://openweathermap.org/appid

An example demonstrating the structure of an API call for forecast data, including the necessary parameters like location ID and API key.

```text
api.openweathermap.org/data/2.5/forecast?id=524901&appid={API key}
```

--------------------------------

### Basic Relief Map URL Example

Source: https://openweathermap.org/api/relief

An example of a basic URL to retrieve relief maps, including the required API key.

```text
http://maps.openweathermap.org/maps/2.0/relief/{z}/{x}/{y}?appid={API key}
```

--------------------------------

### URL Example

Source: https://openweathermap.org/api/fire-index-map

An example of a complete URL for fetching a Fire Weather Index map. Replace placeholders with your actual API key and desired date (Unix time).

```text
https://maps.openweathermap.org/maps/2.0/fwi/4/1/6?appid={API key}&date=1600780200
```

--------------------------------

### Example API Call

Source: https://openweathermap.org/api/uvi

An example of a complete API call with latitude and longitude specified. Replace '{API key}' with your actual API key.

```HTTP
https://api.openweathermap.org/data/3.0/onecall/overview?lon=-11.8092&lat=51.509865&appid={API key}
```

--------------------------------

### API Call Example with JavaScript Callback

Source: https://openweathermap.org/api/forecast30

This example demonstrates how to make an API call and handle the JSON response using a JavaScript callback function for JSONP.

```javascript
test(
{
 "coord":{
    "lon":-0.13,
    "lat":51.51
 },
 "weather":[
    {
       "id":300,
       "main":"Drizzle",
       "description":"light intensity drizzle",
       "icon":"09d"
    }
 ],
 "base":"stations",
 "main":{
    "temp":280.32,
    "pressure":1012,
    "humidity":81,
    "temp_min":279.15,
    "temp_max":281.15
 },
 "visibility":10000,
 "wind":{
    "speed":4.1,
    "deg":80
 },
 "clouds":{
    "all":90
 },
 "dt":1485789600,
 "sys":{
    "type":1,
    "id":5091,
    "message":0.0103,
    "country":"GB",
    "sunrise":1485762037,
    "sunset":1485794875
 },
 "id":2643743,
 "name":"London",
 "cod":200
}
)
```

--------------------------------

### API Call Example with JSONP Callback

Source: https://openweathermap.org/api/forecast16

This example demonstrates how to make an API call and receive the response as a JSONP callback function. This is useful for integrating with JavaScript applications.

```text
test(
{
 "coord":{
    "lon":-0.13,
    "lat":51.51
 },
 "weather":[
    {
       "id":300,
       "main":"Drizzle",
       "description":"light intensity drizzle",
       "icon":"09d"
    }
 ],
 "base":"stations",
 "main":{
    "temp":280.32,
    "pressure":1012,
    "humidity":81,
    "temp_min":279.15,
    "temp_max":281.15
 },
 "visibility":10000,
 "wind":{
    "speed":4.1,
    "deg":80,
    "gust":6.1
 },
 "clouds":{
    "all":90
 },
 "dt":1485789600,
 "sys":{
    "type":1,
    "id":5091,
    "message":0.0103,
    "country":"GB",
    "sunrise":1485762037,
    "sunset":1485794875
 },
 "id":2643743,
 "name":"London",
 "cod":200
}
)
```

--------------------------------

### Clouds Map Layer Example

Source: https://openweathermap.org/api/weathermaps

Example of how to request a clouds weather map layer. This layer shows cloud cover worldwide.

```text
layer : clouds_new
area : worldwide
```

--------------------------------

### JavaScript JSONP Callback Example

Source: https://openweathermap.org/api/current?collection=current_forecast

This example shows how to use a callback function for JSONP requests in JavaScript.

```javascript
function callback(data) {
  // Process the JSONP data here
}
```

--------------------------------

### API Call Example

Source: https://openweathermap.org/api/uvi

This example demonstrates a typical API call to retrieve weather data, including current, minutely, hourly, daily, and alert information.

```APIDOC
## API Call Example

This example demonstrates a typical API call to retrieve weather data, including current, minutely, hourly, daily, and alert information.

### Request Body Example
```json
{
  "lat": 40.12,
  "lon": -96.66,
  "timezone": "America/Chicago",
  "timezone_offset": -18000,
  "current": {
    "dt": 1595243443,
    "sunrise": 1595243663,
    "sunset": 1595296278,
    "temp": 293.28,
    "feels_like": 293.82,
    "pressure": 1016,
    "humidity": 100,
    "dew_point": 293.28,
    "uvi": 10.64,
    "clouds": 90,
    "visibility": 10000,
    "wind_speed": 4.6,
    "wind_deg": 310,
    "weather": [
      {
        "id": 501,
        "main": "Rain",
        "description": "moderate rain",
        "icon": "10n"
      },
      {
        "id": 201,
        "main": "Thunderstorm",
        "description": "thunderstorm with rain",
        "icon": "11n"
      }
    ],
    "rain": {
      "1h": 2.93
    }
  },
  "minutely": [
    {
      "dt": 1595243460,
      "precipitation": 2.928
    }
  ],
  "hourly": [
    {
      "dt": 1595242800,
      "temp": 293.28,
      "feels_like": 293.82,
      "pressure": 1016,
      "humidity": 100,
      "dew_point": 293.28,
      "clouds": 90,
      "visibility": 10000,
      "wind_speed": 4.6,
      "wind_deg": 123,
      "weather": [
        {
          "id": 501,
          "main": "Rain",
          "description": "moderate rain",
          "icon": "10n"
        }
      ],
      "pop": 0.99,
      "rain": {
        "1h": 2.46
      }
    }
  ],
  "daily": [
    {
      "dt": 1595268000,
      "sunrise": 1595243663,
      "sunset": 1595296278,
      "temp": {
        "day": 298.82,
        "min": 293.25,
        "max": 301.9,
        "night": 293.25,
        "eve": 299.72,
        "morn": 293.48
      },
      "feels_like": {
        "day": 300.06,
        "night": 292.46,
        "eve": 300.87,
        "morn": 293.75
      },
      "pressure": 1014,
      "humidity": 82,
      "dew_point": 295.52,
      "wind_speed": 5.22,
      "wind_deg": 146,
      "weather": [
        {
          "id": 502,
          "main": "Rain",
          "description": "heavy intensity rain",
          "icon": "10d"
        }
      ],
      "clouds": 97,
      "pop": 1,
      "rain": 12.57,
      "uvi": 10.64
    }
  ],
  "alerts": [
    {
      "sender_name": "NWS Tulsa (Eastern Oklahoma)",
      "event": "Heat Advisory",
      "start": 1597341600,
      "end": 1597366800,
      "description": "...HEAT ADVISORY REMAINS IN EFFECT FROM 1 PM THIS AFTERNOON TO\n8 PM CDT THIS EVENING...\n* WHAT...Heat index values of 105 to 109 degrees expected.\n* WHERE...Creek, Okfuskee, Okmulgee, McIntosh, Pittsburg,\nLatimer, Pushmataha, and Choctaw Counties.\n* WHEN...From 1 PM to 8 PM CDT Thursday.\n* IMPACTS...The combination of hot temperatures and high\nhumidity will combine to create a dangerous situation in which\nheat illnesses are possible."
    }
  ]
}
```
```

--------------------------------

### Example API Call with Parameters

Source: https://openweathermap.org/api/one-call-4

An example of a complete API call including latitude, longitude, units, language, and API key. Ensure you have the correct subscription for One Call 4.0.

```text
https://api.openweathermap.org/data/4.0/onecall/current?lat=52.2297&lon=21.0122&units=metric&lang=en&appid={API key}
```

--------------------------------

### API Call Example - Standard Units

Source: https://openweathermap.org/api/one-call-4

Example API call using default (standard) units for temperature and wind speed.

```text
https://api.openweathermap.org/data/4.0/onecall/current?lat=30.489772&lon=-99.771335&appid={API key}
```

--------------------------------

### Example API Call for 1 Minute Timeline

Source: https://openweathermap.org/api/one-call-4

An example of a complete API call URL for the 1-minute timeline endpoint, demonstrating the inclusion of latitude, longitude, and API key.

```text
https://api.openweathermap.org/data/4.0/onecall/timeline/1min?lat=51.5&lon=-0.1&appid={API key}
```

--------------------------------

### API Call Example - Multilingual Support

Source: https://openweathermap.org/api/one-call-4

Example API call requesting the output in Simplified Chinese.

```text
https://api.openweathermap.org/data/4.0/onecall/current?lat=30.489772&lon=-99.771335&lang=zh_cn&appid={API key}
```

--------------------------------

### Solar Data API Call Example with Timezone

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

An example API call demonstrating how to include the timezone parameter for a specific location and date.

```text
https://api.openweathermap.org/energy/2.0/location/F01E165B-22F3-4591-89D4-F238E92F6885/interval_data?date=2023-03-30&interval=1h&tz=+05:45&appid={API key}
```

--------------------------------

### XML API Response Example

Source: https://openweathermap.org/api/forecast16

This is an example of the XML response structure for a daily forecast. It includes detailed weather information for multiple days.

```xml
<weatherdata>
<location>
<name>London</name>
<type />
<country>GB</country>
<timezone />
<location altitude="0" latitude="51.5085" longitude="-0.1258" geobase="geonames" geobaseid="2643743" />
</location>
<credit />
<meta>
<lastupdate />
<calctime>0.0117</calctime>
<nextupdate />
</meta>
<sun rise="2017-01-30T07:40:34" set="2017-01-30T16:47:56" />
<forecast>
<time day="2017-01-30">
 <symbol number="500" name="light rain" var="10d" />
 <precipitation value="1.64" type="rain" />
 <windDirection deg="85" code="E" name="East" />
 <windSpeed mps="1.97" name="Light breeze" />
 <windGust gust="3.31" unit="m/s"/>
 <temperature day="7" min="4.34" max="7" night="4.91" eve="5.05" morn="7" />
 <pressure unit="hPa" value="1016.99" />
 <humidity value="100" unit="%" />
 <clouds value="few clouds" all="12" unit="%" />
</time>
<time day="2017-01-31">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="9.42" type="rain" />
 <windDirection deg="140" code="SE" name="SouthEast" />
 <windSpeed mps="3.37" name="" />
 <windGust gust="6.31" unit="m/s"/>
 <temperature day="9.66" min="6.16" max="11.51" night="10.63" eve="10.85" morn="6.16" />
 <pressure unit="hPa" value="1018.15" />
 <humidity value="100" unit="%" />
 <clouds value="overcast clouds" all="92" unit="%" />
</time>
<time day="2017-02-01">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="9.11" type="rain" />
 <windDirection deg="197" code="SSW" name="South-southwest" />
 <windSpeed mps="5.01" name="Gentle Breeze" />
 <windGust gust="6.31" unit="m/s"/>
 <temperature day="9.81" min="9.64" max="10.23" night="10.08" eve="9.81" morn="10.03" />
 <pressure unit="hPa" value="1011.7" />
 <humidity value="99" unit="%" />
 <clouds value="scattered clouds" all="44" unit="%" />
 </time>
 <time day="2017-02-02">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="3.98" type="rain" />
 <windDirection deg="184" code="S" name="South" />
 <windSpeed mps="8.42" name="Fresh Breeze" />
 <windGust gust="10.31" unit="m/s"/>
 <temperature day="11.44" min="8.86" max="11.53" night="8.86" eve="10.99" morn="10.05" />
 <pressure unit="hPa" value="999.34" />
 <humidity value="96" unit="%" />
 <clouds value="overcast clouds" all="92" unit="%" />
</time>
<time day="2017-02-03">
 <symbol number="500" name="light rain" var="10d" />
 <precipitation value="1.65" type="rain" />
 <windDirection deg="213" code="SSW" name="South-southwest" />
 <windSpeed mps="8.51" name="Fresh Breeze" />
 <windGust gust="11.31" unit="m/s"/>
 <temperature day="10.66" min="8.63" max="10.66" night="8.63" eve="9.14" morn="10.18" />
 <pressure unit="hPa" value="1010.98" />
 <humidity value="0" unit="%" />
 <clouds value="scattered clouds" all="48" unit="%" />
</time>
<time day="2017-02-04">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="7.25" type="rain" />
 <windDirection deg="172" code="S" name="South" />
 <windSpeed mps="10.39" name="Fresh Breeze" />
 <temperature day="8.68" min="7.07" max="10.4" night="8.48" eve="10.4" morn="7.07" />
 <pressure unit="hPa" value="1001.13" />
 <humidity value="0" unit="%" />
 <clouds value="overcast clouds" all="96" unit="%" />
</time>
<time day="2017-02-05">
 <symbol number="501" name="moderate rain" var="10d" />
 <precipitation value="4.24" type="rain" />
 <windDirection deg="274" code="W" name="West" />
 <windSpeed mps="6.21" name="Moderate breeze" />
 <windGust gust="9.31" unit="m/s"/>
 <temperature day="8.5" min="4.86" max="8.5" night="4.86" eve="6.25" morn="8.26" />
 <pressure unit="hPa" value="995.24" />
 <humidity value="0" unit="%" />
 <clouds value="broken clouds" all="64" unit="%" />
</time>
</forecast>
</weatherd
```

--------------------------------

### Hourly Forecast API Call Example

Source: https://openweathermap.org/api/hourly-forecast

An example of an API call to retrieve hourly forecast data for specific coordinates. Ensure you replace `{API key}` with your actual key.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?lat=44.34&lon=10.99&appid={API key}
```

--------------------------------

### Add Station

Source: https://openweathermap.org/stations

This section shows an example of how to add a new weather station to your account. It includes the request body format and an example API response.

```APIDOC
## Add Station

### Description
This method is used to add a new weather station to your account.

### Request Body
- **external_id** (string) - Required - Unique identifier for the station.
- **name** (string) - Required - Name of the station.
- **latitude** (number) - Required - Latitude coordinate of the station.
- **longitude** (number) - Required - Longitude coordinate of the station.
- **altitude** (number) - Optional - Altitude of the station in meters.

### Request Example
```json
{
  "external_id": "SF_UPD001",
  "name": "San Francisco Updated Station",
  "latitude": 37.80,
  "longitude": -122.47,
  "altitude": 143
}
```

### Headers
```
Content-Type: application/json
```

### API Response (Success)
- **id** (string) - Unique ID of the created station.
- **created_at** (string) - Timestamp of creation.
- **updated_at** (string) - Timestamp of last update.
- **external_id** (string) - External ID of the station.
- **name** (string) - Name of the station.
- **longitude** (number) - Longitude coordinate.
- **latitude** (number) - Latitude coordinate.
- **altitude** (number) - Altitude of the station.
- **rank** (number) - Rank of the station.

### Response Example (Success)
```json
{
  "id": "583436dd9643a9000196b8d6",
  "created_at": "2016-11-22T12:15:25.967Z",
  "updated_at": "2016-11-22T12:44:20.170544353Z",
  "external_id": "SF_UPD001",
  "name": "San Francisco Updated Station",
  "longitude": -122.47,
  "latitude": 37.8,
  "altitude": 143,
  "rank": 0
}
```
```

--------------------------------

### Example 15-Minute Timeline API Call

Source: https://openweathermap.org/api/one-call-4

An example of a complete API call to the 15-minute timeline endpoint with specific latitude and longitude values.

```text
https://api.openweathermap.org/data/4.0/onecall/timeline/15min?lat=51.5&lon=-0.1&appid={API key}
```

--------------------------------

### API Call Example for XML Format

Source: https://openweathermap.org/api/hourly-forecast

Example of an API call to retrieve weather data specifically in XML format by setting the 'mode' parameter.

```text
api.openweathermap.org/data/2.5/weather?q=London&mode=xml
```

--------------------------------

### Example API Call with Coordinates

Source: https://openweathermap.org/api/current

An example of an API call to fetch current weather data for a specific latitude and longitude. Ensure you replace {API key} with your actual key.

```text
https://api.openweathermap.org/data/2.5/weather?lat=44.34&lon=10.99&appid={API key}
```

--------------------------------

### Sea Level Pressure Map Layer Example

Source: https://openweathermap.org/api/weathermaps

Example of how to request a sea level pressure weather map layer. This layer visualizes pressure patterns globally.

```text
layer : pressure_new
area : worldwide
```

--------------------------------

### Weather Maps API URL Example

Source: https://openweathermap.org/api/weather-map-1h

An example of a complete URL for fetching a specific weather map layer. This URL can be integrated into mapping libraries.

```text
https://maps.openweathermap.org/maps/2.0/weather/1h/TA2/4/1/6?appid={API key}
```

--------------------------------

### Wind Speed Map Layer Example

Source: https://openweathermap.org/api/weathermaps

Example of how to request a wind speed weather map layer. This layer shows wind patterns across the globe.

```text
layer : wind_new
area : worldwide
```

--------------------------------

### Example API Call for 30-Day Climatic Forecast

Source: https://openweathermap.org/api/forecast30

An example of a complete API call for the 30-day climatic forecast, demonstrating the use of latitude, longitude, and API key.

```text
https://pro.openweathermap.org/data/2.5/forecast/climate?lat=35&lon=139&appid={API key}
```

--------------------------------

### API Call Example for JSON Format

Source: https://openweathermap.org/api/hourly-forecast

Example of an API call to retrieve weather data in JSON format. JSON is the default format.

```text
api.openweathermap.org/data/2.5/weather?q=London&appid={API key}
```

--------------------------------

### Current Weather API Response Example

Source: https://openweathermap.org/api/forecast5

This example shows the 'main' object in a Current Weather API response, including current temperature and optional min/max temperatures for reference.

```json
"main":{
  "temp":306.15, //current temperature
  "pressure":1013,
  "humidity":44,
  "temp_min":30.15, //min current temperature in the city
  "temp_max":306.15 //max current temperature in the city
}
```

--------------------------------

### Daily Forecast API Response Example

Source: https://openweathermap.org/api/forecast5

This example illustrates the 'temp' object within a Daily Forecast API response, detailing daily averaged temperature and its min/max values for the day.

```json
"dt":1406080800,
"temp":{
        "day":297.77,  //daily averaged temperature
        "min":293.52, //daily min temperature
        "max":297.77, //daily max temperature
        "night":293.52, //night temperature
        "eve":297.77, //evening temperature
        "morn":297.77} //morning temperature
```

--------------------------------

### Example 1-Day Timeline API Call

Source: https://openweathermap.org/api/one-call-4

An example of a 1-day timeline API call with specific latitude and longitude values. Ensure your API key is included.

```text
https://api.openweathermap.org/data/4.0/onecall/timeline/1day?lat=51.5&lon=-0.1&appid={API key}
```

--------------------------------

### Example OpenWeatherMap Timemachine API Call

Source: https://openweathermap.org/api/uvi

An example of a complete API call to the timemachine endpoint with specific coordinates and timestamp. Replace {API key} with your actual key.

```HTTP
https://api.openweathermap.org/data/3.0/onecall/timemachine?lat=39.099724&lon=-94.578331&dt=1643803200&appid={API key}
```

--------------------------------

### Basic Solar Irradiance API Call Example

Source: https://openweathermap.org/api/solar-irradiance

A simple example of an API call to retrieve solar irradiance data, specifying latitude, longitude, date, and interval.

```text
https://api.openweathermap.org/energy/2.0/solar/interval_data?lat=51.509865&lon=-0.118092&date=2023-10-10&interval=1h&appid={API key}
```

--------------------------------

### API Response Example

Source: https://openweathermap.org/api/forecast30?collection=current_forecast

An example of the JSON response structure returned by the 30-day forecast API, including weather conditions, temperature, wind, and location details.

```APIDOC
## Example of API call
```javascript
test(
{
 "coord":{
    "lon":-0.13,
    "lat":51.51
 },
 "weather":[
    {
       "id":300,
       "main":"Drizzle",
       "description":"light intensity drizzle",
       "icon":"09d"
    }
 ],
 "base":"stations",
 "main":{
    "temp":280.32,
    "pressure":1012,
    "humidity":81,
    "temp_min":279.15,
    "temp_max":281.15
 },
 "visibility":10000,
 "wind":{
    "speed":4.1,
    "deg":80
 },
 "clouds":{
    "all":90
 },
 "dt":1485789600,
 "sys":{
    "type":1,
    "id":5091,
    "message":0.0103,
    "country":"GB",
    "sunrise":1485762037,
    "sunset":1485794875
 },
 "id":2643743,
 "name":"London",
 "cod":200
}
)
```
```

--------------------------------

### 5 Day / 3 Hour Forecast API Call Example

Source: https://openweathermap.org/api/forecast5

This is an example of how to construct an API call to retrieve the 5-day weather forecast with 3-hour intervals using geographic coordinates.

```text
api.openweathermap.org/data/2.5/forecast?lat={lat}&lon={lon}&appid={API key}
```

--------------------------------

### Hourly Forecast API Call Example by City ID

Source: https://openweathermap.org/api/hourly-forecast

An example of an API call to get hourly forecast data using a city ID.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?id=524901&appid={API key}
```

--------------------------------

### Layer Tint URL Example

Source: https://openweathermap.org/api/relief

Shows how to apply a layer tint to Relief maps by setting the 'mix_w' parameter to 0.

```text
http://maps.openweathermap.org/maps/2.0/relief/{z}/{x}/{y}?mix_w=0&appid={API key}
```

--------------------------------

### Example Current Fire Weather Index API Call

Source: https://openweathermap.org/api/fire-index-api

An example of an API call to get current Fire Weather Index data for a specific latitude and longitude.

```text
https://api.openweathermap.org/data/2.5/fwi?lat=24&lon=-103&appid={API key}
```

--------------------------------

### Example Accumulated Precipitation API Call

Source: https://openweathermap.org/api/accumulated-parameters

An example of a complete API call to the Accumulated Precipitation endpoint, demonstrating the use of latitude, longitude, start and end dates, and an API key.

```http
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?lat=51.51&lon=-0.12&start=1586853378&end=1589445367&appid={API key}
```

--------------------------------

### Example Accumulated Temperature API Call

Source: https://openweathermap.org/api/accumulated-parameters

An example of a complete API call for accumulated temperature, demonstrating the use of latitude, longitude, start and end dates, a threshold value, and an API key.

```text
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?lat=51.51&lon=-0.13&start=1586853378&end=1589445367&threshold=284&appid={API key}
```

--------------------------------

### Example Monthly Aggregation API Call

Source: https://openweathermap.org/api/statistics-api?collection=historical

An example of a complete API call to retrieve monthly aggregated historical weather data for February, including latitude, longitude, and API key.

```HTTP
https://history.openweathermap.org/data/2.5/aggregated/month?month=2&lat=35&lon=139&appid={API key}
```

--------------------------------

### Get Historical Air Pollution Data

Source: https://openweathermap.org/api/air-pollution

This endpoint retrieves historical air pollution data. You need to provide the latitude, longitude, start and end timestamps, and your API key.

```APIDOC
## GET /data/2.5/air_pollution/history

### Description
Retrieves historical air pollution data for a specified location and time range.

### Method
GET

### Endpoint
`http://api.openweathermap.org/data/2.5/air_pollution/history?lat={lat}&lon={lon}&start={start}&end={end}&appid={API key}`

### Parameters
#### Query Parameters
- **lat** (number) - Required - Latitude of the location.
- **lon** (number) - Required - Longitude of the location.
- **start** (integer) - Required - Start date in Unix time (UTC).
- **end** (integer) - Required - End date in Unix time (UTC).
- **appid** (string) - Required - Your unique API key.

### Response
#### Success Response (200)
- **coord** (array) - Coordinates [latitude, longitude].
- **list** (array) - Array of historical data points.
  - **dt** (integer) - Date and time, Unix, UTC.
  - **main** (object)
    - **aqi** (integer) - Air Quality Index (1-5).
  - **components** (object)
    - **co** (number) - Concentration of CO (μg/m3).
    - **no** (number) - Concentration of NO (μg/m3).
    - **no2** (number) - Concentration of NO2 (μg/m3).
    - **o3** (number) - Concentration of O3 (μg/m3).
    - **so2** (number) - Concentration of SO2 (μg/m3).
    - **pm2_5** (number) - Concentration of PM2.5 (μg/m3).
    - **pm10** (number) - Concentration of PM10 (μg/m3).
    - **nh3** (number) - Concentration of NH3 (μg/m3).

### Response Example
```json
{
  "coord": [
    50,
    50
  ],
  "list": [
    {
      "dt": 1605182400,
      "main": {
        "aqi": 1
      },
      "components": {
        "co": 201.94053649902344,
        "no": 0.01877197064459324,
        "no2": 0.7711350917816162,
        "o3": 68.66455078125,
        "so2": 0.6407499313354492,
        "pm2_5": 0.5,
        "pm10": 0.540438711643219,
        "nh3": 0.12369127571582794
      }
    }
  ]
}
```
```

--------------------------------

### Get Historical Weather Data by City Name (with end date)

Source: https://openweathermap.org/api/history?collection=historical

Retrieve hourly historical weather data for a specified city using its name and country code, along with a start and end date.

```APIDOC
## GET /data/2.5/history/city

### Description
Retrieves hourly historical weather data for a specified city.

### Method
GET

### Endpoint
https://history.openweathermap.org/data/2.5/history/city

### Parameters
#### Query Parameters
- **q** (string) - Required - City name, state code and country code divided by comma. Example: London,UK
- **type** (string) - Required - Type of the call, must be `hour`.
- **appid** (string) - Required - Your unique API key.
- **start** (integer) - Optional - Start date in Unix time (UTC). Example: 1369728000
- **end** (integer) - Optional - End date in Unix time (UTC). Example: 1369789200
```

--------------------------------

### URL Example for Weather Maps

Source: https://openweathermap.org/api/weather-map-1h

This is an example URL demonstrating how to request a specific weather map layer (HRD0 - Relative humidity) for a given date and time. Replace '{API key}' with your actual API key.

```text
https://maps.openweathermap.org/maps/2.0/weather/1h/HRD0/4/1/6?date=1618898990&appid={API key}
```

--------------------------------

### Get Historical Weather Data by City Name (with count)

Source: https://openweathermap.org/api/history?collection=historical

Retrieve hourly historical weather data for a specified city using its name and country code, along with a start date and a count of hourly records.

```APIDOC
## GET /data/2.5/history/city

### Description
Retrieves hourly historical weather data for a specified city using a count of records.

### Method
GET

### Endpoint
https://history.openweathermap.org/data/2.5/history/city

### Parameters
#### Query Parameters
- **q** (string) - Required - City name, state code and country code divided by comma. Example: London,UK
- **type** (string) - Required - Type of the call, must be `hour`.
- **appid** (string) - Required - Your unique API key.
- **start** (integer) - Optional - Start date in Unix time (UTC). Example: 1369728000
- **cnt** (integer) - Optional - A number of timestamps in response (one per hour). Can be used instead of `end`.
```

--------------------------------

### Example Weather Maps 2.0 API Call

Source: https://openweathermap.org/api/weather-map-2

An example of a complete URL for fetching a specific weather map layer with custom parameters. Ensure you replace `{API key}` with your actual key.

```text
http://maps.openweathermap.org/maps/2.0/weather/TA2/{z}/{x}/{y}?date=1552861800&opacity=0.9&fill_bound=true&appid={API key}
```

--------------------------------

### Get Historical Data by City ID

Source: https://openweathermap.org/api/history?collection=historical

Retrieves historical weather data for a specified city using its unique ID. You can define the time range using start and end dates, or specify the number of data points to retrieve.

```APIDOC
## GET /data/2.5/history/city

### Description
Retrieves historical weather data for a specified city using its unique ID. This endpoint allows for flexible data retrieval by specifying time ranges or the number of data points.

### Method
GET

### Endpoint
https://history.openweathermap.org/data/2.5/history/city

### Parameters
#### Query Parameters
- **id** (string) - Required - City ID. The list of city IDs can be downloaded from the provided link.
- **type** (string) - Required - Type of the call, must be `hour`.
- **appid** (string) - Required - Your unique API key.
- **start** (integer) - Optional - Start date in Unix time (UTC). Example: `start=1369728000`.
- **end** (integer) - Optional - End date in Unix time (UTC). Example: `end=1369789200`.
- **cnt** (integer) - Optional - Amount of returned data (one per hour, can be used instead of `end`).
- **units** (string) - Optional - Units of measurement: `standard` (default, Kelvin, m/s), `metric` (Celsius, m/s), `imperial` (Fahrenheit, miles/hour).

### Request Example
```http
GET https://history.openweathermap.org/data/2.5/history/city?id=2885679&type=hour&appid={API key}
```

### Response
#### Success Response (200)
- The response contains historical weather data for the specified city and time range.

#### Response Example
```json
{
  "example": "response body"
}
```

**Note:** For Professional and Expert plans, the maximum historical data depth in one API response is one week. For longer periods, multiple queries are necessary.
```

--------------------------------

### Get City History by Date Range

Source: https://openweathermap.org/history

Retrieves hourly historical weather data for a specified city within a given date range. Requires city name, country code, start and end dates (Unix timestamps), and an API key.

```APIDOC
## GET /data/2.5/history/city

### Description
Retrieves hourly historical weather data for a specified city within a given date range. Requires city name, country code, start and end dates (Unix timestamps), and an API key.

### Method
GET

### Endpoint
https://history.openweathermap.org/data/2.5/history/city

### Parameters
#### Query Parameters
- **q** (string) - Required - City name, state code and country code divided by comma, please refer to ISO 3166 for the state codes or country codes. You can specify the parameter not only in English. In this case, the API response should be returned in the same language as the language of requested location name if the location is in our predefined list of more than 200,000 locations.
- **type** (string) - Required - type of the call, keep this parameter in the API call as `hour`
- **appid** (string) - Required - Your unique API key (you can always find it on your account page under the "API key" tab)
- **start** (integer) - Optional - Start date (unix time, UTC time zone), e.g. start=1369728000
- **end** (integer) - Optional - End date (unix time, UTC time zone), e.g. end=1369789200

### Request Example
```
https://history.openweathermap.org/data/2.5/history/city?q=London,UK&appid={API key}
```

### Response
#### Success Response (200)
- **data** (array) - Historical weather data points.
- **city_info** (object) - Information about the city.

#### Response Example
{
  "example": "{\"list\":[{\"dt\":1369728000,\"main\":{\"temp\":283.15,\"feels_like\":282.15,\"temp_min\":282.15,\"temp_max\":284.15,\"pressure\":1012,\"humidity\":80}},...],\"city\":{\"id\":2643743,\"name\":\"London\",\"coord\":{\"lat\":51.5073219,\"lon\":-0.1276474},\"country\":\"GB\",\"population\":0,\"timezone\":3600,\"sunrise\":1369715400,\"sunset\":1369774200}}" 
}
```

--------------------------------

### JSON Response Example

Source: https://openweathermap.org/api/current

An example of the API response when data is requested in JSON format.

```APIDOC
## JSON Response Example

```json
{
   "coord":{
      "lon":-0.13,
      "lat":51.51
   },
   "weather":[
      {
         "id":300,
         "main":"Drizzle",
         "description":"light intensity drizzle",
         "icon":"09d"
      }
   ],
   "base":"stations",
   "main":{
      "temp":280.32,
      "pressure":1012,
      "humidity":81,
      "temp_min":279.15,
      "temp_max":281.15
   },
   "visibility":10000,
   "wind":{
      "speed":4.1,
      "deg":80
   },
   "clouds":{
      "all":90
   },
   "dt":1485789600,
   "sys":{
      "type":1,
      "id":5091,
      "message":0.0103,
      "country":"GB",
      "sunrise":1485762037,
      "sunset":1485794875
   },
   "id":2643743,
   "name":"London",
   "cod":200
  }
```
```

--------------------------------

### Start Session - AI Weather Assistant

Source: https://openweathermap.org/api/uvi

Initiates a session with the AI Weather Assistant to ask questions about weather and receive related advice. This method returns an HTTP 200 on successful creation.

```APIDOC
## POST /weather-assistant

### Description
Starts a session to interact with the AI Weather Assistant, enabling users to ask questions about weather conditions and receive advice.

### Method
POST

### Endpoint
/weather-assistant

### Headers
- **Content-Type**: application/json
- **X-Api-Key**: [your OpenWeather API key]

### Request Body
(No specific request body schema provided, but implies a prompt or query will be sent)

### Response
#### Success Response (200)
- (Response details not explicitly defined, but indicates successful session initiation)

### Request Example
(No explicit request example provided in the source text)

### Response Example
(No explicit response example provided in the source text)
```