Add qweather

2024-11-27 12:45:28 +08:00
parent 27a1364db8
commit eafa229360
1 changed files with 129 additions and 0 deletions
--- a/qweather.yml
+++ b/qweather.yml
@@ -0,0 +1,129 @@
+openapi: "3.1.0"
+info:
+  title: 和风天气API
+  version: '1'
+servers: 
+  - url: https://devapi.qweather.com
+components: 
+  securitySchemes: 
+    apiKey:
+      name: 'X-QW-Api-Key'
+      in: header
+      type: apiKey
+security: 
+  - apiKey: []
+paths:
+  /v7/weather/now:
+    get:
+      operationId: getWeatherNow
+      summary: 获取实时天气
+      servers: 
+        - url: https://devapi.qweather.com
+      parameters:
+        - name: location
+          in: query
+          required: true
+          description: >
+            需要查询地区的LocationID或以英文逗号分隔的经度, 纬度坐标（十进制，最多支持小数点后两位）。 
+            LocationID可通过GeoAPI获取。例如：location=101010100 或 location=116.41,39.92
+          schema:
+            type: string
+        - name: lang
+          in: query
+          required: false
+          description: >
+            多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。
+          schema:
+            type: string
+        - name: unit
+          in: query
+          required: false
+          description: >
+            数据单位设置，可选值包括unit=m（公制单位，默认）和unit=i（英制单位）。 
+            更多选项和说明参考度量衡单位。
+          schema:
+            type: string
+            enum:
+              - m
+              - i
+      responses:
+        '200':
+          description: 返回天气数据
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code:
+                    type: string
+                    example: "200"
+                  updateTime:
+                    type: string
+                    format: date-time
+                    example: "2020-06-30T22:00+08:00"
+                  fxLink:
+                    type: string
+                    format: uri
+                    example: "http://hfx.link/2ax1"
+                  now:
+                    type: object
+                    properties:
+                      obsTime:
+                        type: string
+                        format: date-time
+                        example: "2020-06-30T21:40+08:00"
+                      temp:
+                        type: string
+                        example: "24"
+                      feelsLike:
+                        type: string
+                        example: "26"
+                      icon:
+                        type: string
+                        example: "101"
+                      text:
+                        type: string
+                        example: "多云"
+                      wind360:
+                        type: string
+                        example: "123"
+                      windDir:
+                        type: string
+                        example: "东南风"
+                      windScale:
+                        type: string
+                        example: "1"
+                      windSpeed:
+                        type: string
+                        example: "3"
+                      humidity:
+                        type: string
+                        example: "72"
+                      precip:
+                        type: string
+                        example: "0.0"
+                      pressure:
+                        type: string
+                        example: "1003"
+                      vis:
+                        type: string
+                        example: "16"
+                      cloud:
+                        type: string
+                        example: "10"
+                      dew:
+                        type: string
+                        example: "21"
+                  refer:
+                    type: object
+                    properties:
+                      sources:
+                        type: array
+                        items:
+                          type: string
+                          example: "QWeather"
+                      license:
+                        type: array
+                        items:
+                          type: string
+                          example: "QWeather Developers License"