# Generated by ShowAPI OpenAPI generator
# source: market/3540
# generated-at: 2026-07-17T07:20:57.543Z
openapi: 3.0.3
info:
  title: 天气预报国际版
  description: 通过全球多个天气服务商和高分辨率本地天气模型的合作，提供对全球数百万个地点天气信息的访问
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /3540-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 经纬度查询14天预报
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          dayList:
                            type: array
                            items:
                              type: object
                              properties:
                                max_temperature:
                                  type: number
                                  description: 最高气温
                                visibility:
                                  type: number
                                  description: 能见度
                                moon_phase:
                                  type: string
                                  description: 月相
                                moonrise:
                                  type: string
                                  description: 月出时间
                                humidity:
                                  type: number
                                  description: 湿度
                                min_temperature:
                                  type: number
                                  description: 最低气温
                                rain_prop:
                                  type: number
                                  description: 降雨概率
                                weather:
                                  type: string
                                  description: 天气
                                uv:
                                  type: number
                                  description: 紫外线指数
                                date:
                                  type: string
                                  description: 日期
                                moon_illumination:
                                  type: number
                                  description: 月光亮度
                                moonset:
                                  type: string
                                  description: 日落时间
                                total_precip:
                                  type: number
                                  description: 总降水量（mm）
                                sunrise:
                                  type: string
                                  description: 日出时间
                                max_wind_speed:
                                  type: number
                                  description: 最大风速
                                snow_prob:
                                  type: number
                                  description: 降雪概率
                                total_snow:
                                  type: number
                                  description: 总降雪量（cm）
                                weather_en:
                                  type: string
                                  description: 天气（英文）
                                temperature:
                                  type: number
                                  description: 平均气温
                                sunset:
                                  type: string
                                  description: 日落时间
                                moon_phase_en:
                                  type: string
                                  description: 月相（英文）
                                max_temperature_f:
                                  type: number
                                  description: 最高气温（华氏）
                                min_temperature_f:
                                  type: number
                                  description: 最低气温（华氏）
                                temperature_f:
                                  type: number
                                  description: 平均气温（华氏）
                            description: 预报列表
                          cityInfo:
                            type: object
                            properties:
                              time_zone:
                                type: string
                                description: 时区
                              city:
                                type: string
                                description: 城市
                              region:
                                type: string
                                description: 地区
                              country:
                                type: string
                                description: 国家和地区
                              longitude:
                                type: number
                                description: 经度
                              localtime:
                                type: string
                                description: 当地时间
                              latitude:
                                type: number
                                description: 纬度
                            description: 城市信息
                          remark:
                            type: string
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                        description: 业务返回体
      operationId: 3540_3_POST
      parameters:
        - name: lon
          in: query
          description: 经度
          required: true
          schema:
            type: string
        - name: lat
          in: query
          description: 纬度
          required: true
          schema:
            type: string
  /3540-2:
    x-pointCode: 2
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 经纬度查询24小时预报
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          remark:
                            type: string
                          cityInfo:
                            type: object
                            properties:
                              time_zone:
                                type: string
                                description: 时区
                              city:
                                type: string
                                description: 城市
                              region:
                                type: string
                                description: 地区
                              country:
                                type: string
                                description: 国家和地区
                              longitude:
                                type: number
                                description: 经度
                              localtime:
                                type: string
                                description: 当地时间
                              latitude:
                                type: number
                                description: 纬度
                            description: 城市信息
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          hourList:
                            type: array
                            items:
                              type: object
                              properties:
                                wind_direction:
                                  type: string
                                  description: 风向
                                pressure:
                                  type: number
                                  description: 大气压
                                dew_point:
                                  type: number
                                  description: 露点温度
                                humidity:
                                  type: number
                                  description: 湿度
                                snow:
                                  type: number
                                  description: 降雪量
                                wind_speed:
                                  type: number
                                  description: 持续风速（m/s）
                                time:
                                  type: string
                                  description: 小时时间（当地）
                                gust_speed:
                                  type: number
                                  description: 阵风风速（m/s）
                                cloud:
                                  type: number
                                  description: 云层覆盖率（%）
                                rain_prop:
                                  type: number
                                  description: 降雨概率
                                short_rad:
                                  type: number
                                  description: 短波太阳辐射或全球水平辐射（W/m²）
                                dni:
                                  type: number
                                  description: 直接辐射（W/m²）
                                uv:
                                  type: number
                                  description: 紫外线指数
                                snow_prob:
                                  type: number
                                  description: 降雪概率
                                weather:
                                  type: string
                                  description: 天气
                                visibility:
                                  type: number
                                  description: 能见度（km）
                                gti:
                                  type: number
                                  description: 倾角辐射（W/m²）
                                diff_rad:
                                  type: number
                                  description: 水平面散射日射量（衡量太阳辐射）（W/m²）
                                feels_like:
                                  type: number
                                  description: 体感温度
                                temperature:
                                  type: number
                                  description: 气温
                                weather_en:
                                  type: string
                                  description: 天气（英文）
                                windchill:
                                  type: number
                                  description: 风寒指数
                                wind_direction_en:
                                  type: string
                                  description: 风向（英文）
                                heat_index:
                                  type: number
                                  description: 热指数
                                temperature_f:
                                  type: number
                                  description: 气温（华氏）
                                feels_like_f:
                                  type: number
                                  description: 体感温度（华氏）
                                windchill_f:
                                  type: number
                                  description: 风寒温度（华氏）
                                heat_index_f:
                                  type: number
                                  description: 热指数（华氏）
                                dew_point_f:
                                  type: number
                                  description: 露点温度（华氏）
                            description: 24小时预报列表
                        description: 业务返回体
      operationId: 3540_2_POST
      parameters:
        - name: lon
          in: query
          description: 经度
          required: true
          schema:
            type: string
        - name: lat
          in: query
          description: 纬度
          required: true
          schema:
            type: string
  /3540-1:
    x-pointCode: 1
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 经纬度查询当前天气
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          remark:
                            type: string
                          cityInfo:
                            type: object
                            properties:
                              time_zone:
                                type: string
                                description: 时区
                              region:
                                type: string
                                description: 地区
                              area:
                                type: string
                                description: 城市
                              country:
                                type: string
                                description: 国家和地区
                              longitude:
                                type: number
                                description: 经度
                              localtime:
                                type: string
                                description: 当地时间
                              latitude:
                                type: number
                                description: 纬度
                            description: 城市信息
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          now:
                            type: object
                            properties:
                              heat_index:
                                type: number
                                description: 热指数
                              pressure:
                                type: number
                                description: 大气压
                              dew_point:
                                type: number
                                description: 露点温度
                              diff_rad:
                                type: number
                                description: 水平面散射日射量（衡量太阳辐射）（W/m²）
                              wind_speed:
                                type: number
                                description: 持续风速（m/s）
                              air_quality:
                                type: object
                                properties:
                                  primary_pollutant:
                                    type: string
                                    description: 主要污染物
                                  aqi:
                                    type: number
                                    description: 空气质量指数
                                  pm10:
                                    type: number
                                    description: PM10 (μg/m3)
                                  o3:
                                    type: number
                                    description: 臭氧 (μg/m3)
                                  so2:
                                    type: number
                                    description: 二氧化硫 (μg/m3)
                                  no2:
                                    type: number
                                    description: 二氧化氮 (μg/m3)
                                  co:
                                    type: number
                                    description: 一氧化碳 (μg/m3)
                                  pm2_5:
                                    type: number
                                    description: PM2.5 (μg/m3)
                                description: 空气质量
                              gust_speed:
                                type: number
                                description: 阵风风速（m/s）
                              cloud:
                                type: number
                                description: 云层覆盖率（%）
                              rain_prop:
                                type: number
                                description: 下雨概率
                              short_rad:
                                type: number
                                description: 短波太阳辐射或全球水平辐射（W/m²）
                              dni:
                                type: number
                                description: 散射辐射（W/m²）
                              uv:
                                type: number
                                description: 紫外线指数
                              snow_prob:
                                type: number
                                description: 下雪概率
                              weather:
                                type: string
                                description: 天气
                              visibility:
                                type: number
                                description: 能见度（km）
                              gti:
                                type: number
                                description: 倾角辐射（W/m²）
                              windchill:
                                type: number
                                description: 风寒指数
                              feels_like:
                                type: number
                                description: 体感温度
                              wind_direction_en:
                                type: string
                                description: 风向（英文）
                              weather_en:
                                type: string
                                description: 天气（英文）
                              temperature:
                                type: number
                                description: 气温
                              wind_direction:
                                type: string
                                description: 风向
                              humidity:
                                type: number
                                description: 湿度
                              temperature_f:
                                type: number
                                description: 气温（华氏）
                              feels_like_f:
                                type: number
                                description: 体感温度（华氏）
                              windchill_f:
                                type: number
                                description: 风寒温度（华氏）
                              heat_index_f:
                                type: number
                                description: 热指数（华氏）
                              dew_point_f:
                                type: number
                                description: 露点温度（华氏）
                            description: 当前天气
                        description: 业务返回体
      operationId: 3540_1_POST
      parameters:
        - name: lon
          in: query
          description: 经度
          required: true
          schema:
            type: string
        - name: lat
          in: query
          description: 纬度
          required: true
          schema:
            type: string
components:
  securitySchemes:
    AppKeyAuth:
      type: apiKey
      in: query
      name: appKey
      description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp
  schemas:
    ShowapiResEnvelope:
      type: object
      description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）
      properties:
        showapi_res_code:
          type: integer
          description: API 返回的状态码
        showapi_res_error:
          type: string
          description: API 返回的错误信息
        showapi_res_id:
          type: string
          description: API 请求的唯一标识
        showapi_fee_num:
          type: integer
          description: API 调用计费次数
security:
  - AppKeyAuth: []
externalDocs:
  url: https://www.showapi.com/apiGateway/view/3540?tab=book
x-apiCode: "3540"
x-is-own: false
x-is-op: false
