From 0ffd99b255a0bf0e91455d0b8d6afef4d1b3cd52 Mon Sep 17 00:00:00 2001 From: lifegpc Date: Wed, 27 Nov 2024 17:30:03 +0800 Subject: [PATCH] Update --- qweather-geoapi.yml | 130 +++++++++++++++++++++++++++++++++++++++++++ qweather.yml | 133 +------------------------------------------- 2 files changed, 132 insertions(+), 131 deletions(-) create mode 100644 qweather-geoapi.yml diff --git a/qweather-geoapi.yml b/qweather-geoapi.yml new file mode 100644 index 0000000..20af163 --- /dev/null +++ b/qweather-geoapi.yml @@ -0,0 +1,130 @@ +openapi: "3.1.0" +info: + title: 和风天气GEOAPI + version: 'v1' +servers: + - url: https://geoapi.qweather.com +components: + securitySchemes: + apiKey: + name: 'X-QW-Api-Key' + in: header + type: apiKey +security: + - apiKey: [] +paths: + /v2/city/lookup: + get: + operationId: lookupCity + summary: 城市搜索 + servers: + - url: https://geoapi.qweather.com + parameters: + - name: location + in: query + required: true + description: > + 需要查询地区的名称，支持文字、以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位）、LocationID或Adcode（仅限中国城市）。 + schema: + type: string + examples: + - 北京 + - 116.41,39.92 + - name: adm + in: query + required: false + description: 城市的上级行政区划，可设定只在某个行政区划范围内进行搜索，用于排除重名城市或对结果进行过滤。 + schema: + type: string + example: beijing + - name: range + in: query + required: false + description: 搜索范围，可设定只在某个国家或地区范围内进行搜索，国家和地区名称需使用ISO 3166 所定义的国家代码。如果不设置此参数，搜索范围将在所有城市。 + schema: + type: string + example: cn + - name: number + in: query + required: false + description: 返回结果的数量，取值范围1-20，默认返回10个结果。 + schema: + type: integer + default: 10 + - name: lang + in: query + required: false + description: > + 多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。 + schema: + type: string + default: zh + enum: ['zh', 'zh-hans', 'zh-hant'] + responses: + '200': + description: 结果 + content: + application/json: + schema: + type: object + properties: + code: + type: string + example: '200' + location: + type: array + items: + type: object + properties: + name: + type: string + example: '北京' + id: + type: string + example: '101010100' + lat: + type: string + example: '39.90499' + lon: + type: string + example: '116.40529' + adm2: + type: string + example: '北京' + adm1: + type: string + example: '北京市' + country: + type: string + example: '中国' + tz: + type: string + example: 'Asia/Shanghai' + utcOffset: + type: string + example: '+08:00' + isDst: + type: string + example: '0' + type: + type: string + example: 'city' + rank: + type: string + example: '10' + fxLink: + type: string + example: 'https://www.qweather.com/weather/beijing-101010100.html' + refer: + type: object + properties: + sources: + type: array + items: + type: string + example: 'QWeather' + license: + type: array + items: + type: string + example: 'QWeather Developers License' diff --git a/qweather.yml b/qweather.yml index 569bde9..0c6da88 100644 --- a/qweather.yml +++ b/qweather.yml @@ -1,15 +1,9 @@ openapi: "3.1.0" info: title: 和风天气API - version: '1' + version: 'v1' servers: - - url: https://{var}.qweather.com - variables: - var: - default: devapi - enum: - - devapi - - geoapi + - url: https://devapi.qweather.com components: securitySchemes: apiKey: @@ -19,133 +13,10 @@ components: security: - apiKey: [] paths: - /v2/city/lookup: - get: - operationId: lookupCity - summary: 城市搜索 - servers: - - url: https://{var}.qweather.com - variables: - var: - default: geoapi - enum: - - devapi - - geoapi - parameters: - - name: location - in: query - required: true - description: > - 需要查询地区的名称，支持文字、以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位）、LocationID或Adcode（仅限中国城市）。 - schema: - type: string - examples: - - 北京 - - 116.41,39.92 - - name: adm - in: query - required: false - description: 城市的上级行政区划，可设定只在某个行政区划范围内进行搜索，用于排除重名城市或对结果进行过滤。 - schema: - type: string - example: beijing - - name: range - in: query - required: false - description: 搜索范围，可设定只在某个国家或地区范围内进行搜索，国家和地区名称需使用ISO 3166 所定义的国家代码。如果不设置此参数，搜索范围将在所有城市。 - schema: - type: string - example: cn - - name: number - in: query - required: false - description: 返回结果的数量，取值范围1-20，默认返回10个结果。 - schema: - type: integer - default: 10 - - name: lang - in: query - required: false - description: > - 多语言设置，请阅读多语言文档，了解我们的多语言是如何工作、如何设置以及数据是否支持多语言。 - schema: - type: string - default: zh - enum: ['zh', 'zh-hans', 'zh-hant'] - responses: - '200': - description: 结果 - content: - application/json: - schema: - type: object - properties: - code: - type: string - example: '200' - location: - type: array - items: - type: object - properties: - name: - type: string - example: '北京' - id: - type: string - example: '101010100' - lat: - type: string - example: '39.90499' - lon: - type: string - example: '116.40529' - adm2: - type: string - example: '北京' - adm1: - type: string - example: '北京市' - country: - type: string - example: '中国' - tz: - type: string - example: 'Asia/Shanghai' - utcOffset: - type: string - example: '+08:00' - isDst: - type: string - example: '0' - type: - type: string - example: 'city' - rank: - type: string - example: '10' - fxLink: - type: string - example: 'https://www.qweather.com/weather/beijing-101010100.html' - refer: - type: object - properties: - sources: - type: array - items: - type: string - example: 'QWeather' - license: - type: array - items: - type: string - example: 'QWeather Developers License' /v7/weather/now: get: operationId: getWeatherNow summary: 获取实时天气 - servers: - - url: https://devapi.qweather.com parameters: - name: location in: query