{
  "opencollection": "1.0.0",
  "info": {
    "name": "Caiyun Weather API",
    "version": "2.6"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "token",
      "value": "{{token}}",
      "placement": "query"
    }
  },
  "items": [
    {
      "info": {
        "name": "Realtime",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Caiyun Weather Get Realtime Weather",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.caiyunapp.com/v2.6/:token/:lnglat/realtime",
            "params": [
              {
                "name": "token",
                "value": "TAkhjf8d1nlSlspN",
                "type": "path",
                "description": "Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather than a header."
              },
              {
                "name": "lnglat",
                "value": "116.4074,39.9042",
                "type": "path",
                "description": "Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees."
              },
              {
                "name": "lang",
                "value": "en_US",
                "type": "query",
                "description": "Response language for description fields."
              },
              {
                "name": "unit",
                "value": "metric:v2",
                "type": "query",
                "description": "Unit system for numeric values (temperature, wind, precipitation, pressure)."
              }
            ]
          },
          "docs": "Returns the current weather conditions at the requested location — temperature, humidity, wind, cloud cover, sky condition (skycon), visibility, downward shortwave radiation, pressure, apparent temperature, precipitation, air quality, and life indices."
        }
      ]
    },
    {
      "info": {
        "name": "Forecast",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Caiyun Weather Get Minutely Precipitation Forecast",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.caiyunapp.com/v2.6/:token/:lnglat/minutely",
            "params": [
              {
                "name": "token",
                "value": "TAkhjf8d1nlSlspN",
                "type": "path",
                "description": "Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather than a header."
              },
              {
                "name": "lnglat",
                "value": "116.4074,39.9042",
                "type": "path",
                "description": "Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees."
              },
              {
                "name": "lang",
                "value": "en_US",
                "type": "query",
                "description": "Response language for description fields."
              },
              {
                "name": "unit",
                "value": "metric:v2",
                "type": "query",
                "description": "Unit system for numeric values (temperature, wind, precipitation, pressure)."
              }
            ]
          },
          "docs": "Returns 120-minute minute-level precipitation nowcast (mm/hr) and per-minute probability series for the requested location, plus a natural-language summary of the precipitation pattern."
        },
        {
          "info": {
            "name": "Caiyun Weather Get Hourly Weather Forecast",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.caiyunapp.com/v2.6/:token/:lnglat/hourly",
            "params": [
              {
                "name": "token",
                "value": "TAkhjf8d1nlSlspN",
                "type": "path",
                "description": "Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather than a header."
              },
              {
                "name": "lnglat",
                "value": "116.4074,39.9042",
                "type": "path",
                "description": "Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees."
              },
              {
                "name": "lang",
                "value": "en_US",
                "type": "query",
                "description": "Response language for description fields."
              },
              {
                "name": "unit",
                "value": "metric:v2",
                "type": "query",
                "description": "Unit system for numeric values (temperature, wind, precipitation, pressure)."
              },
              {
                "name": "hourlysteps",
                "value": "72",
                "type": "query",
                "description": "Number of hourly forecast steps to return."
              },
              {
                "name": "begin",
                "value": "1748563200",
                "type": "query",
                "description": "Anchor the forecast or historical series at a specific Unix epoch second instead of \"now\". Used to fetch past 24h (historical) or shift the start of the forecast window."
              }
            ]
          },
          "docs": "Returns hourly forecast series for up to 360 hours covering temperature, apparent temperature, humidity, cloud cover, sky condition, precipitation (value + probability), pressure, visibility, downward shortwave radiation, wind, and air quality (AQI + PM2.5). When the begin parameter is supplied the series is anchored at that Unix epoch second instead of \"now\"."
        },
        {
          "info": {
            "name": "Caiyun Weather Get Daily Weather Forecast",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.caiyunapp.com/v2.6/:token/:lnglat/daily",
            "params": [
              {
                "name": "token",
                "value": "TAkhjf8d1nlSlspN",
                "type": "path",
                "description": "Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather than a header."
              },
              {
                "name": "lnglat",
                "value": "116.4074,39.9042",
                "type": "path",
                "description": "Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees."
              },
              {
                "name": "lang",
                "value": "en_US",
                "type": "query",
                "description": "Response language for description fields."
              },
              {
                "name": "unit",
                "value": "metric:v2",
                "type": "query",
                "description": "Unit system for numeric values (temperature, wind, precipitation, pressure)."
              },
              {
                "name": "dailysteps",
                "value": "7",
                "type": "query",
                "description": "Number of daily forecast days to return. Free tier caps at 3."
              },
              {
                "name": "begin",
                "value": "1748563200",
                "type": "query",
                "description": "Anchor the forecast or historical series at a specific Unix epoch second instead of \"now\". Used to fetch past 24h (historical) or shift the start of the forecast window."
              }
            ]
          },
          "docs": "Returns daily forecast series for up to 15 days covering astronomical sunrise/sunset, precipitation, temperature, humidity, cloud cover, pressure, visibility, downward shortwave radiation, wind, sky condition, air quality, and life indices. Includes daytime (08h-20h) and nighttime (20h-32h) splits for skycon, precipitation, temperature, and wind. Free tier returns 3 days; paid tiers extend to 15."
        }
      ]
    },
    {
      "info": {
        "name": "Weather",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Caiyun Weather Get Combined Weather Envelope",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.caiyunapp.com/v2.6/:token/:lnglat/weather",
            "params": [
              {
                "name": "token",
                "value": "TAkhjf8d1nlSlspN",
                "type": "path",
                "description": "Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather than a header."
              },
              {
                "name": "lnglat",
                "value": "116.4074,39.9042",
                "type": "path",
                "description": "Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees."
              },
              {
                "name": "lang",
                "value": "en_US",
                "type": "query",
                "description": "Response language for description fields."
              },
              {
                "name": "unit",
                "value": "metric:v2",
                "type": "query",
                "description": "Unit system for numeric values (temperature, wind, precipitation, pressure)."
              },
              {
                "name": "dailysteps",
                "value": "7",
                "type": "query",
                "description": "Number of daily forecast days to return. Free tier caps at 3."
              },
              {
                "name": "hourlysteps",
                "value": "72",
                "type": "query",
                "description": "Number of hourly forecast steps to return."
              },
              {
                "name": "alert",
                "value": "true",
                "type": "query",
                "description": "Include severe-weather alerts in the combined weather response."
              },
              {
                "name": "begin",
                "value": "1748563200",
                "type": "query",
                "description": "Anchor the forecast or historical series at a specific Unix epoch second instead of \"now\". Used to fetch past 24h (historical) or shift the start of the forecast window."
              },
              {
                "name": "granu",
                "value": "hourly",
                "type": "query",
                "description": "Restrict the combined /weather response to a single granularity instead of returning the full envelope."
              }
            ]
          },
          "docs": "Returns a combined response containing realtime, minutely, hourly, and daily forecast blocks in a single call, optionally with severe- weather alerts. The granu parameter narrows the response to a single granularity (realtime, minutely, hourly, daily) when only part of the envelope is needed."
        }
      ]
    },
    {
      "info": {
        "name": "Air Quality",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Caiyun Weather Get Realtime Air Quality",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.caiyunapp.com/v2.6/:token/:lnglat/air-quality",
            "params": [
              {
                "name": "token",
                "value": "TAkhjf8d1nlSlspN",
                "type": "path",
                "description": "Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather than a header."
              },
              {
                "name": "lnglat",
                "value": "116.4074,39.9042",
                "type": "path",
                "description": "Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees."
              },
              {
                "name": "lang",
                "value": "en_US",
                "type": "query",
                "description": "Response language for description fields."
              }
            ]
          },
          "docs": "Returns real-time air quality readings — PM2.5, PM10, O3, SO2, NO2, CO concentrations plus AQI values and category descriptions under both Chinese (HJ 633-2012) and US EPA standards."
        }
      ]
    },
    {
      "info": {
        "name": "Alerts",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Caiyun Weather Get Severe Weather Alerts",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.caiyunapp.com/v2.6/:token/:lnglat/alert",
            "params": [
              {
                "name": "token",
                "value": "TAkhjf8d1nlSlspN",
                "type": "path",
                "description": "Caiyun Weather API token issued by the Open Platform (platform.caiyunapp.com). Embedded in the path rather than a header."
              },
              {
                "name": "lnglat",
                "value": "116.4074,39.9042",
                "type": "path",
                "description": "Longitude,latitude tuple as `lng,lat` (note the order — longitude first). Use WGS84 decimal degrees."
              },
              {
                "name": "lang",
                "value": "en_US",
                "type": "query",
                "description": "Response language for description fields."
              }
            ]
          },
          "docs": "Returns the active severe-weather alerts published by the China Meteorological Administration for the requested location, including title, code, status, description, region (province/city/county), adcode, publication timestamp, and originating source."
        }
      ]
    },
    {
      "info": {
        "name": "Precipitation Map",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Caiyun Weather Get Precipitation Map Tile",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.caiyunapp.com/v2.6/precipitation/:z/:x/:y.png",
            "params": [
              {
                "name": "z",
                "value": "",
                "type": "path",
                "description": "Web Mercator zoom level (0-9 typical)."
              },
              {
                "name": "x",
                "value": "",
                "type": "path",
                "description": "Web Mercator tile column."
              },
              {
                "name": "y",
                "value": "",
                "type": "path",
                "description": "Web Mercator tile row."
              },
              {
                "name": "timestamp",
                "value": "",
                "type": "query",
                "description": "Optional Unix epoch second for the nowcast frame. Omit to receive the most recent observation; provide a future timestamp within the nowcast horizon to render a forecast frame."
              }
            ]
          },
          "docs": "Returns a 256x256 PNG raster tile representing radar + nowcast precipitation intensity colored by the standard dBZ palette. Suitable for overlaying on Web Mercator base maps (Mapbox, MapLibre, OpenLayers, Leaflet) to render live precipitation animations."
        }
      ]
    }
  ],
  "bundled": true
}