{ "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": { "/342-3": { "x-pointCode": 3, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "台风历史列表", "description": "查询当前台风的坐标位置、风向、风力、风速、气压等，可形成一条完整的台风运动轨迹数据线。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "ret_code": { "type": "number" }, "typhoon_list": { "type": "array", "items": { "type": "object", "properties": { "tfid": { "type": "string", "description": "台风id" }, "name": { "type": "string", "description": "中文名称" }, "en": { "type": "string", "description": "英文名称" }, "explain": { "type": "string", "description": "名字来源" } } }, "description": "台风列表" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "342_3_POST", "parameters": [ { "name": "year", "in": "query", "description": "格式：yyyy\n【不输入默认当前年份】", "required": false, "schema": { "type": "string" } } ] } }, "/342-2": { "x-pointCode": 2, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "单个台风详情", "description": "查询当前台风的坐标位置、风向、风力、风速、气压等，可形成一条完整的台风运动轨迹数据线。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "obj": { "type": "array", "items": { "type": "object", "properties": { "enname": { "type": "string", "description": "英文名" }, "lat": { "type": "string", "description": "维度" }, "lng": { "type": "string", "description": "经度" }, "movedirection": { "type": "string", "description": "风向" }, "movespeed": { "type": "string", "description": "台风整体移动速度，单位【公里/小时】。" }, "name": { "type": "string", "description": "中文名" }, "power": { "type": "string", "description": "风力，单位【级】" }, "pressure": { "type": "string", "description": "气压 单位【百帕】" }, "radius10": { "type": "string", "description": "10级风力影响半径" }, "radius7": { "type": "string", "description": "7级风力影响半径" }, "speed": { "type": "string", "description": "风速，单位【米/每秒】" }, "strong": { "type": "string", "description": "风力等级描述" }, "tfid": { "type": "string", "description": "台风id" }, "time": { "type": "string", "description": "数据更新时间" } } }, "description": "台风对象" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "342_2_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "tfid": { "type": "string", "description": "台风标识，此标准识对应【当前台风列表】中查出来的tfid" } }, "required": [ "tfid" ] } } } } } }, "/342-1": { "x-pointCode": 1, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "当前台风列表", "description": "获取当前的台风列表及其基本数据。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "enname": { "type": "string", "description": "英文名" }, "lat": { "type": "string", "description": "维度" }, "lng": { "type": "string", "description": "经度" }, "movedirection": { "type": "string", "description": "风向" }, "movespeed": { "type": "string", "description": "台风整体移动速度，单位【公里/小时】。" }, "name": { "type": "string", "description": "中文名" }, "power": { "type": "string", "description": "风力，单位【级】" }, "pressure": { "type": "string", "description": "气压 单位【百帕】" }, "radius10": { "type": "string", "description": "10级风力影响半径" }, "radius7": { "type": "string", "description": "7级风力影响半径" }, "speed": { "type": "string", "description": "风速，单位【米/每秒】" }, "strong": { "type": "string", "description": "风力等级描述" }, "tfid": { "type": "string", "description": "台风id" }, "time": { "type": "string", "description": "数据更新时间" } } }, "description": "台风列表对象" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "342_1_POST", "parameters": [] } } }, "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/342?tab=book" }, "x-apiCode": "342", "x-is-own": false, "x-is-op": true }