{"openapi":"3.1.0","info":{"title":"Ocean Weather API","description":"近海气象 + 离线海图合并服务。\n\n## 鉴权\n- 气象接口（`/v1/forecast` 等）：API Key，按 `credit_calls` 计次。\n- 海图接口（`/v1/map/*`、`/tiles/*`）：同一 API Key，另需**有效海图订阅**（不扣气象额度）。\n- 管理端（`/admin/*`）：管理员 JWT。\n\n## 海图瓦片\n- 标准路径：`GET /v1/map/{layer}/{z}/{x}/{y}.png`（`y` 也可不带扩展名）\n- 短别名：`GET /tiles/{layer}/{z}/{x}/{y}.png`\n- 图层：`base` / `coastosm` / `hires` / `seamark`（融合预览按此顺序叠加）以及 `combined` / `sat` / `amapbase` 等\n- 元数据：`/v1/map/layers`、`/v1/map/{layer}/tilejson.json`、`/v1/map/stats`、`/v1/map/downloads`\n- 订阅：见标签 **map-billing**（`/v1/map/plans`、`/subscription`、`/orders`）\n\n浏览器预览见 `/map/leaflet.html`；压测在管理端海图概览页。","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["health"],"summary":"Health Check","description":"健康检查端点。\n\n返回服务状态、运行时间、各数据源最新数据时间和存储统计。\n此端点不需要鉴权。","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/v1/forecast":{"get":{"tags":["forecast"],"summary":"Get Forecast","description":"获取天气预报数据。\n\n查询指定经纬度的天气预报时间序列。支持多变量同时请求，\n自动处理衍生变量计算和多数据源融合。\n\n示例::\n    /v1/forecast?latitude=37.5&longitude=122.3&hourly=temperature_2m,wind_speed_10m&forecast_days=3","operationId":"get_forecast_v1_forecast_get","parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"description":"纬度","title":"Latitude"},"description":"纬度"},{"name":"longitude","in":"query","required":true,"schema":{"type":"number","maximum":360,"minimum":-180,"description":"经度","title":"Longitude"},"description":"经度"},{"name":"hourly","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"小时变量，逗号分隔","title":"Hourly"},"description":"小时变量，逗号分隔"},{"name":"daily","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"日变量，逗号分隔","title":"Daily"},"description":"日变量，逗号分隔"},{"name":"current","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"当前变量，逗号分隔","title":"Current"},"description":"当前变量，逗号分隔"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 YYYY-MM-DD","title":"Start Date"},"description":"开始日期 YYYY-MM-DD"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 YYYY-MM-DD","title":"End Date"},"description":"结束日期 YYYY-MM-DD"},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","description":"时区","default":"auto","title":"Timezone"},"description":"时区"},{"name":"past_days","in":"query","required":false,"schema":{"type":"integer","maximum":92,"minimum":0,"description":"历史天数","default":0,"title":"Past Days"},"description":"历史天数"},{"name":"forecast_days","in":"query","required":false,"schema":{"type":"integer","maximum":16,"minimum":1,"description":"预报天数","default":7,"title":"Forecast Days"},"description":"预报天数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/marine":{"get":{"tags":["marine"],"summary":"Get Marine","description":"获取海洋数据。\n\n查询指定经纬度的海洋变量时间序列（波浪、洋流等）。\n\n示例::\n    /v1/marine?latitude=37.5&longitude=122.3&hourly=wave_height,wave_direction&current=wave_height","operationId":"get_marine_v1_marine_get","parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"description":"纬度","title":"Latitude"},"description":"纬度"},{"name":"longitude","in":"query","required":true,"schema":{"type":"number","maximum":360,"minimum":-180,"description":"经度","title":"Longitude"},"description":"经度"},{"name":"hourly","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"小时变量，逗号分隔","title":"Hourly"},"description":"小时变量，逗号分隔"},{"name":"daily","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"日变量，逗号分隔","title":"Daily"},"description":"日变量，逗号分隔"},{"name":"current","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"当前变量，逗号分隔","title":"Current"},"description":"当前变量，逗号分隔"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"开始日期 YYYY-MM-DD","title":"Start Date"},"description":"开始日期 YYYY-MM-DD"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束日期 YYYY-MM-DD","title":"End Date"},"description":"结束日期 YYYY-MM-DD"},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","description":"时区","default":"auto","title":"Timezone"},"description":"时区"},{"name":"past_days","in":"query","required":false,"schema":{"type":"integer","maximum":92,"minimum":0,"description":"历史天数","default":0,"title":"Past Days"},"description":"历史天数"},{"name":"forecast_days","in":"query","required":false,"schema":{"type":"integer","maximum":16,"minimum":1,"description":"预报天数","default":7,"title":"Forecast Days"},"description":"预报天数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarineResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tide/stations":{"get":{"tags":["tide"],"summary":"潮汐站列表","description":"列出潮汐站；可按中心点+半径或 bbox 过滤。","operationId":"list_stations_v1_tide_stations_get","parameters":[{"name":"longitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":360,"minimum":-180},{"type":"null"}],"description":"中心经度（与 latitude/radius_km 联用）","title":"Longitude"},"description":"中心经度（与 latitude/radius_km 联用）"},{"name":"latitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"中心纬度","title":"Latitude"},"description":"中心纬度"},{"name":"radius_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":500,"exclusiveMinimum":0},{"type":"null"}],"description":"搜索半径（公里）","title":"Radius Km"},"description":"搜索半径（公里）"},{"name":"min_lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"bbox 西界","title":"Min Lon"},"description":"bbox 西界"},{"name":"max_lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"bbox 东界","title":"Max Lon"},"description":"bbox 东界"},{"name":"min_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"bbox 南界","title":"Min Lat"},"description":"bbox 南界"},{"name":"max_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"bbox 北界","title":"Max Lat"},"description":"bbox 北界"},{"name":"enabled_only","in":"query","required":false,"schema":{"type":"boolean","description":"仅返回启用站","default":true,"title":"Enabled Only"},"description":"仅返回启用站"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Stations V1 Tide Stations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tide/nearest":{"get":{"tags":["tide"],"summary":"最近潮汐站","operationId":"nearest_station_v1_tide_nearest_get","parameters":[{"name":"longitude","in":"query","required":true,"schema":{"type":"number","maximum":360,"minimum":-180,"description":"经度","title":"Longitude"},"description":"经度"},{"name":"latitude","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"description":"纬度","title":"Latitude"},"description":"纬度"},{"name":"max_km","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":500,"exclusiveMinimum":0},{"type":"null"}],"description":"最大距离（公里），默认配置 nearest_max_km","title":"Max Km"},"description":"最大距离（公里），默认配置 nearest_max_km"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Nearest Station V1 Tide Nearest Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tide":{"get":{"tags":["tide"],"summary":"潮位时序（逐小时 + 高低潮）","description":"返回逐小时潮高与高低潮极值。\n\n数据来自本地滚动缓存 ``data/tide/{station_id}/{yyyyMMdd}.json``；\n若尚未采集，请在管理台对 ``qweather_tide`` 执行下载。","operationId":"get_tide_v1_tide_get","parameters":[{"name":"station_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"和风潮汐站 LocationID","title":"Station Id"},"description":"和风潮汐站 LocationID"},{"name":"longitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":360,"minimum":-180},{"type":"null"}],"description":"经度（未指定 station_id 时必填）","title":"Longitude"},"description":"经度（未指定 station_id 时必填）"},{"name":"latitude","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":90,"minimum":-90},{"type":"null"}],"description":"纬度（未指定 station_id 时必填）","title":"Latitude"},"description":"纬度（未指定 station_id 时必填）"},{"name":"forecast_days","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"预报天数（含今天）","default":7,"title":"Forecast Days"},"description":"预报天数（含今天）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Tide V1 Tide Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/typhoon/active":{"get":{"tags":["typhoon"],"summary":"当前活跃台风列表","description":"返回当前所有状态为 active 的台风信息。","operationId":"get_active_typhoons_v1_typhoon_active_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Active Typhoons V1 Typhoon Active Get"}}}}}}},"/v1/typhoon/list":{"get":{"tags":["typhoon"],"summary":"台风列表（可含已停编）","description":"返回台风列表；默认活跃，可选已停编或全部。","operationId":"list_typhoons_v1_typhoon_list_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","pattern":"^(active|dissipated|all)$","description":"筛选状态: active / dissipated / all","default":"active","title":"Status"},"description":"筛选状态: active / dissipated / all"},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"年份筛选（可选）","title":"Year"},"description":"年份筛选（可选）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Typhoons V1 Typhoon List Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/typhoon/detail/{typhoon_id}":{"get":{"tags":["typhoon"],"summary":"台风详情","description":"返回指定台风的完整信息，包含实况路径和分机构预报路径。","operationId":"get_typhoon_detail_v1_typhoon_detail__typhoon_id__get","parameters":[{"name":"typhoon_id","in":"path","required":true,"schema":{"type":"string","title":"Typhoon Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Typhoon Detail V1 Typhoon Detail  Typhoon Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/typhoon/history":{"get":{"tags":["typhoon"],"summary":"历史台风列表","description":"返回历史台风列表，支持按年份和海域筛选。","operationId":"get_typhoon_history_v1_typhoon_history_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"年份筛选","title":"Year"},"description":"年份筛选"},{"name":"basin","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"海域: WP/EP/NA/IO","title":"Basin"},"description":"海域: WP/EP/NA/IO"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Typhoon History V1 Typhoon History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ship/query":{"get":{"tags":["ship"],"summary":"单船综合查询","description":"根据船舶经纬度返回气象+海洋+台风综合数据。","operationId":"query_ship_v1_ship_query_get","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"description":"纬度","title":"Lat"},"description":"纬度"},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"description":"经度","title":"Lon"},"description":"经度"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"description":"预报时长（小时）","default":48,"title":"Hours"},"description":"预报时长（小时）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Query Ship V1 Ship Query Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ship/batch":{"post":{"tags":["ship"],"summary":"批量船舶查询","description":"批量查询多艘船舶的综合气象海洋数据。","operationId":"batch_query_post_v1_ship_batch_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchQueryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Batch Query Post V1 Ship Batch Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ship"],"summary":"批量查询（GET 兼容）","description":"通过 GET 参数批量查询。lats 和 lons 逗号分隔。","operationId":"batch_query_get_v1_ship_batch_get","parameters":[{"name":"lats","in":"query","required":true,"schema":{"type":"string","description":"纬度列表，逗号分隔","title":"Lats"},"description":"纬度列表，逗号分隔"},{"name":"lons","in":"query","required":true,"schema":{"type":"string","description":"经度列表，逗号分隔","title":"Lons"},"description":"经度列表，逗号分隔"},{"name":"ids","in":"query","required":false,"schema":{"type":"string","description":"船舶 ID 列表，逗号分隔","default":"","title":"Ids"},"description":"船舶 ID 列表，逗号分隔"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"description":"预报时长（小时）","default":48,"title":"Hours"},"description":"预报时长（小时）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Batch Query Get V1 Ship Batch Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/grid":{"get":{"tags":["grid"],"summary":"Get Grid","description":"获取区域网格数据（单时刻）。\n\n返回指定区域内各变量的二维数组。\n\n示例::\n    /v1/grid?bbox=120,35,125,40&variables=wind_u_component_10m,wind_v_component_10m&time=2026-09-15T12:00&resolution=0.25","operationId":"get_grid_v1_grid_get","parameters":[{"name":"bbox","in":"query","required":true,"schema":{"type":"string","description":"包围框: lon_min,lat_min,lon_max,lat_max","title":"Bbox"},"description":"包围框: lon_min,lat_min,lon_max,lat_max"},{"name":"variables","in":"query","required":true,"schema":{"type":"string","description":"变量列表，逗号分隔","title":"Variables"},"description":"变量列表，逗号分隔"},{"name":"time","in":"query","required":true,"schema":{"type":"string","description":"目标时间 ISO 格式","title":"Time"},"description":"目标时间 ISO 格式"},{"name":"resolution","in":"query","required":false,"schema":{"type":"number","maximum":5.0,"minimum":0.01,"description":"分辨率（度）","default":0.25,"title":"Resolution"},"description":"分辨率（度）"},{"name":"interpolation","in":"query","required":false,"schema":{"type":"string","description":"插值方式","default":"nearest","title":"Interpolation"},"description":"插值方式"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GridResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/grid/timeseries":{"get":{"tags":["grid"],"summary":"Get Grid Timeseries","description":"获取区域网格时序数据。\n\n返回多个时刻的二维数组集合。\n\n示例::\n    /v1/grid/timeseries?bbox=120,35,125,40&variables=wind_u_component_10m&start=2026-09-15T00:00&end=2026-09-16T00:00&step=3h","operationId":"get_grid_timeseries_v1_grid_timeseries_get","parameters":[{"name":"bbox","in":"query","required":true,"schema":{"type":"string","description":"包围框: lon_min,lat_min,lon_max,lat_max","title":"Bbox"},"description":"包围框: lon_min,lat_min,lon_max,lat_max"},{"name":"variables","in":"query","required":true,"schema":{"type":"string","description":"变量列表，逗号分隔","title":"Variables"},"description":"变量列表，逗号分隔"},{"name":"start","in":"query","required":true,"schema":{"type":"string","description":"起始时间 ISO 格式","title":"Start"},"description":"起始时间 ISO 格式"},{"name":"end","in":"query","required":true,"schema":{"type":"string","description":"结束时间 ISO 格式","title":"End"},"description":"结束时间 ISO 格式"},{"name":"step","in":"query","required":false,"schema":{"type":"string","description":"时间步长（如 1h, 3h, 6h）","default":"3h","title":"Step"},"description":"时间步长（如 1h, 3h, 6h）"},{"name":"resolution","in":"query","required":false,"schema":{"type":"number","maximum":5.0,"minimum":0.01,"description":"分辨率（度）","default":0.25,"title":"Resolution"},"description":"分辨率（度）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GridResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/photon/layers":{"get":{"tags":["photon"],"summary":"List Render Layers","description":"列出全部渲染图层及其可用状态。\n\n前端渲染图层选择器、判断哪个图层当前有数据，都只需要这一个接口。\n\n示例::\n    /v1/photon/layers","operationId":"list_render_layers_v1_photon_layers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhotonLayersResponse"}}}}}}},"/v1/photon/times":{"get":{"tags":["photon"],"summary":"List Layer Times","description":"列出某图层可用的全部时刻。\n\n动画取的是真实时间轴上的点，前端拿这份列表就能直接做时间轴选择器。\n\n示例::\n    /v1/photon/times?layer=wind","operationId":"list_layer_times_v1_photon_times_get","parameters":[{"name":"layer","in":"query","required":true,"schema":{"type":"string","description":"图层 id，见 /v1/photon/layers","title":"Layer"},"description":"图层 id，见 /v1/photon/layers"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhotonTimesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/photon/field":{"get":{"tags":["photon"],"summary":"Get Field","description":"取单个图层在单个时刻的渲染场。\n\n返回的 ``header`` + ``components`` 就是一份可直接上屏的规则网格场：\n矢量层含 ``u`` / ``v`` / ``speed``，标量层含 ``value``。\n\n示例::\n    /v1/photon/field?layer=wind&bbox=100,0,150,40\n    /v1/photon/field?layer=temperature&bbox=-180,-60,180,60&resolution=2","operationId":"get_field_v1_photon_field_get","parameters":[{"name":"layer","in":"query","required":true,"schema":{"type":"string","description":"图层 id，见 /v1/photon/layers","title":"Layer"},"description":"图层 id，见 /v1/photon/layers"},{"name":"bbox","in":"query","required":true,"schema":{"type":"string","description":"包围框: lon_min,lat_min,lon_max,lat_max","title":"Bbox"},"description":"包围框: lon_min,lat_min,lon_max,lat_max"},{"name":"time","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"目标时刻（UTC ISO），留空取最接近当前时刻的一帧","title":"Time"},"description":"目标时刻（UTC ISO），留空取最接近当前时刻的一帧"},{"name":"resolution","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10.0,"minimum":0.01},{"type":"null"}],"description":"目标分辨率（度），留空用原生分辨率","title":"Resolution"},"description":"目标分辨率（度），留空用原生分辨率"},{"name":"max_points","in":"query","required":false,"schema":{"type":"integer","maximum":400000,"minimum":100,"description":"单帧格点上限，超出自动抽稀","default":40000,"title":"Max Points"},"description":"单帧格点上限，超出自动抽稀"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhotonFieldResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/photon/animation":{"get":{"tags":["photon"],"summary":"Get Animation","description":"取单个图层的多帧渲染场，供前端做时间播放。\n\n帧时刻会吸附到数据源真实的时间轴上（不做插值），因此每一帧都是实际存在的\n数据；网格几何在帧间保持一致，只有数据随时间变化。\n\n示例::\n    /v1/photon/animation?layer=wind&bbox=100,0,150,40&step=6&max_frames=8","operationId":"get_animation_v1_photon_animation_get","parameters":[{"name":"layer","in":"query","required":true,"schema":{"type":"string","description":"图层 id，见 /v1/photon/layers","title":"Layer"},"description":"图层 id，见 /v1/photon/layers"},{"name":"bbox","in":"query","required":true,"schema":{"type":"string","description":"包围框: lon_min,lat_min,lon_max,lat_max","title":"Bbox"},"description":"包围框: lon_min,lat_min,lon_max,lat_max"},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"起始时刻（UTC ISO），留空取时间轴起点","title":"Start"},"description":"起始时刻（UTC ISO），留空取时间轴起点"},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"结束时刻（UTC ISO），留空取时间轴终点","title":"End"},"description":"结束时刻（UTC ISO），留空取时间轴终点"},{"name":"step","in":"query","required":false,"schema":{"type":"integer","maximum":48,"minimum":1,"description":"帧间隔（小时）","default":3,"title":"Step"},"description":"帧间隔（小时）"},{"name":"max_frames","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"description":"帧数上限","default":24,"title":"Max Frames"},"description":"帧数上限"},{"name":"resolution","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10.0,"minimum":0.01},{"type":"null"}],"description":"目标分辨率（度），留空用原生分辨率","title":"Resolution"},"description":"目标分辨率（度），留空用原生分辨率"},{"name":"max_points","in":"query","required":false,"schema":{"type":"integer","maximum":400000,"minimum":100,"description":"单帧格点上限，超出自动抽稀","default":20000,"title":"Max Points"},"description":"单帧格点上限，超出自动抽稀"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhotonAnimationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/geo/search":{"get":{"tags":["geo"],"summary":"Search","description":"按地名检索经纬度。\n\n匹配顺序为「全名精确 → 别名精确 → 前缀 → 包含」，同分时城市与港口\n优先于海区。\n\n示例::\n    /v1/geo/search?q=青岛\n    /v1/geo/search?q=tokyo&limit=3","operationId":"search_v1_geo_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"地名、拼音或英文名，如 上海 / shanghai / 渤海","title":"Q"},"description":"地名、拼音或英文名，如 上海 / shanghai / 渤海"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"返回条数上限","default":10,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeoSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/geo/reverse":{"get":{"tags":["geo"],"summary":"Reverse","description":"按坐标反查最近的地名。\n\n结果按球面距离升序，``distance_km`` 为该地名到查询坐标的距离。\n\n示例::\n    /v1/geo/reverse?lat=31.2&lon=121.5","operationId":"reverse_v1_geo_reverse_get","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"description":"纬度","title":"Lat"},"description":"纬度"},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":360,"minimum":-180,"description":"经度","title":"Lon"},"description":"经度"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"返回条数上限","default":5,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeoSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/geo/places":{"get":{"tags":["geo"],"summary":"Places","description":"列出内置地名库，供前端填充下拉选项或批量取点。","operationId":"places_v1_geo_places_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":"string","description":"按类型过滤: all / city / port / sea / island / station","default":"all","title":"Kind"},"description":"按类型过滤: all / city / port / sea / island / station"},{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"可选的名称过滤词，留空返回全部","default":"","title":"Q"},"description":"可选的名称过滤词，留空返回全部"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数上限","default":200,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeoSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/register":{"post":{"tags":["auth"],"summary":"Register","description":"用户注册 —— 提交注册申请，等待管理员审批。\n\n账号创建后处于待审批状态，默认 API Key 已生成但不可用；\n审批通过后赠送免费额度即可直接调用。","operationId":"register_v1_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/trial":{"post":{"tags":["auth"],"summary":"Create Trial Account","description":"一键创建体验账号 —— 免审批，立即获得体验额度。\n\n控制台与光子示例页的「生成演示密钥」走这个接口，\n这样没有管理员在场也能把示例跑起来。","operationId":"create_trial_account_v1_auth_trial_post","responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterResponse"}}}}}}},"/v1/auth/login":{"post":{"tags":["auth"],"summary":"Login","description":"用户登录（校验密码）。","operationId":"login_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","description":"登出（客户端删除 token 即可，服务端无状态）。","operationId":"logout_v1_auth_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Logout V1 Auth Logout Post"}}}}}}},"/v1/auth/me":{"get":{"tags":["auth"],"summary":"Get Me","description":"获取当前用户信息（含审批状态与剩余额度）。","operationId":"get_me_v1_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInfo"}}}}}}},"/v1/auth/quota":{"get":{"tags":["auth"],"summary":"Get Quota","description":"查询剩余额度与用量。","operationId":"get_quota_v1_auth_quota_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaResponse"}}}}}}},"/v1/auth/usage":{"get":{"tags":["auth"],"summary":"Get Usage","description":"查询当前用户用量（与 /quota 同源，保留原路径兼容）。","operationId":"get_usage_v1_auth_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaResponse"}}}}}}},"/v1/auth/usage/daily":{"get":{"tags":["auth"],"summary":"Get Daily Usage","description":"最近 N 天的每日调用量 —— 用户中心的用量趋势。","operationId":"get_daily_usage_v1_auth_usage_daily_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyUsageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/calls":{"get":{"tags":["auth"],"summary":"List My Calls","description":"当前用户最近的接口调用记录。","operationId":"list_my_calls_v1_auth_calls_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallLogsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/keys":{"get":{"tags":["auth"],"summary":"List Keys","description":"获取当前用户的所有 API Key。","operationId":"list_keys_v1_auth_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ApiKeyResponse"},"type":"array","title":"Response List Keys V1 Auth Keys Get"}}}}}},"post":{"tags":["auth"],"summary":"Create Key","description":"创建新 API Key。","operationId":"create_key_v1_auth_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/keys/{key_id}":{"delete":{"tags":["auth"],"summary":"Delete Key","description":"删除 API Key。","operationId":"delete_key_v1_auth_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Key V1 Auth Keys  Key Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/keys/{key_id}/reset":{"post":{"tags":["auth"],"summary":"Reset Key","description":"重置 API Key（生成新密钥）。","operationId":"reset_key_v1_auth_keys__key_id__reset_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/packages":{"get":{"tags":["recharge"],"summary":"List Packages","description":"充值套餐与支付渠道目录（公开）。","operationId":"list_packages_v1_auth_packages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RechargePackagesResponse"}}}}}}},"/v1/auth/recharge/orders":{"post":{"tags":["recharge"],"summary":"Create Recharge Order","description":"创建充值订单并返回支付二维码。","operationId":"create_recharge_order_v1_auth_recharge_orders_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RechargeOrderCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RechargeOrderInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["recharge"],"summary":"List Recharge Orders","description":"当前用户的充值记录。","operationId":"list_recharge_orders_v1_auth_recharge_orders_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RechargeOrdersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/recharge/orders/{order_no}":{"get":{"tags":["recharge"],"summary":"Get Recharge Order","description":"查询单个订单 —— 充值页靠它轮询支付结果。","operationId":"get_recharge_order_v1_auth_recharge_orders__order_no__get","parameters":[{"name":"order_no","in":"path","required":true,"schema":{"type":"string","title":"Order No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RechargeOrderInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/recharge/orders/{order_no}/pay":{"post":{"tags":["recharge"],"summary":"Pay Recharge Order","description":"模拟支付成功回调：标记订单已支付并把额度计入账户。\n\n真实接入网关时，这里换成网关异步通知的验签 + 幂等入账即可，\n订单状态流转与额度计算逻辑不变。","operationId":"pay_recharge_order_v1_auth_recharge_orders__order_no__pay_post","parameters":[{"name":"order_no","in":"path","required":true,"schema":{"type":"string","title":"Order No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RechargeOrderInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/plans":{"get":{"tags":["map-billing"],"summary":"List Map Plans","operationId":"list_map_plans_v1_map_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/map/subscription":{"get":{"tags":["map-billing"],"summary":"Get My Map Subscription","operationId":"get_my_map_subscription_v1_map_subscription_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/map/orders":{"post":{"tags":["map-billing"],"summary":"Create Map Order","operationId":"create_map_order_v1_map_orders_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapOrderCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["map-billing"],"summary":"List Map Orders","operationId":"list_map_orders_v1_map_orders_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/orders/{order_no}":{"get":{"tags":["map-billing"],"summary":"Get Map Order","operationId":"get_map_order_v1_map_orders__order_no__get","parameters":[{"name":"order_no","in":"path","required":true,"schema":{"type":"string","title":"Order No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/orders/{order_no}/pay":{"post":{"tags":["map-billing"],"summary":"Pay Map Order","description":"虚拟支付回调：支付成功后延长/复活订阅。","operationId":"pay_map_order_v1_map_orders__order_no__pay_post","parameters":[{"name":"order_no","in":"path","required":true,"schema":{"type":"string","title":"Order No"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MapOrderPay"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/layers":{"get":{"tags":["map"],"summary":"图层清单","description":"机器可读的图层清单。`expose_only_fused` 开启时仅强调融合相关层。","operationId":"map_layers_v1_map_layers_get","parameters":[{"name":"apikey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。","title":"Apikey"},"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。"}],"responses":{"200":{"description":"对外可列出的图层 id / 类型 / 路径","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/sources":{"get":{"tags":["map"],"summary":"数据源清单","operationId":"map_sources_v1_map_sources_get","parameters":[{"name":"apikey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。","title":"Apikey"},"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。"}],"responses":{"200":{"description":"Martin catalog 兼容的数据源列表","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/stats":{"get":{"tags":["map"],"summary":"瓦片服务指标","description":"返回 `cache_hits` / `cache_misses` / `cache_size` / `layers_available`。","operationId":"map_stats_v1_map_stats_get","parameters":[{"name":"apikey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。","title":"Apikey"},"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。"}],"responses":{"200":{"description":"进程内 LRU 命中与图层可用数","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/downloads":{"get":{"tags":["map"],"summary":"下载任务进度","description":"扫描 mbtiles_dir / logs 下的 `*.progress.json`。无进行中任务时 jobs 为空。","operationId":"map_downloads_v1_map_downloads_get","parameters":[{"name":"apikey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。","title":"Apikey"},"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。"}],"responses":{"200":{"description":"正在运行的 download_tiles 任务进度汇总","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/{layer}/tilejson.json":{"get":{"tags":["map"],"summary":"图层 TileJSON","description":"标准 TileJSON。`tiles` 数组含带 `{z}/{x}/{y}` 的绝对 URL，可直接给 Leaflet / MapLibre。","operationId":"map_tilejson_v1_map__layer__tilejson_json_get","parameters":[{"name":"layer","in":"path","required":true,"schema":{"type":"string","title":"Layer"}},{"name":"apikey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。","title":"Apikey"},"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。"}],"responses":{"200":{"description":"范围 / 层级 / tiles 模板 URL","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/map/{layer}/{z}/{x}/{y}":{"get":{"tags":["map"],"summary":"读取一张瓦片","description":"XYZ 瓦片。`y` 可为 `13` 或 `13.png` / `13.jpg`。\n图层示例：`base`、`coastosm`、`hires`、`seamark`、`combined`、`sat`、`amapbase`。","operationId":"map_tile_v1_map__layer___z___x___y__get","parameters":[{"name":"layer","in":"path","required":true,"schema":{"type":"string","title":"Layer"}},{"name":"z","in":"path","required":true,"schema":{"type":"integer","title":"Z"}},{"name":"x","in":"path","required":true,"schema":{"type":"integer","title":"X"}},{"name":"y","in":"path","required":true,"schema":{"type":"string","title":"Y"}},{"name":"apikey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。","title":"Apikey"},"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。"}],"responses":{"200":{"description":"PNG/JPEG 字节；无数据时 204","content":{"application/json":{"schema":{}},"image/png":{},"image/jpeg":{}}},"204":{"description":"该坐标在层级范围内但库中无瓦片（留白）"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tiles/{layer}/{z}/{x}/{y}":{"get":{"tags":["map-alias"],"summary":"瓦片短别名","operationId":"tiles_alias_tiles__layer___z___x___y__get","parameters":[{"name":"layer","in":"path","required":true,"schema":{"type":"string","title":"Layer"}},{"name":"z","in":"path","required":true,"schema":{"type":"integer","title":"Z"}},{"name":"x","in":"path","required":true,"schema":{"type":"integer","title":"X"}},{"name":"y","in":"path","required":true,"schema":{"type":"string","title":"Y"}},{"name":"apikey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。","title":"Apikey"},"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。"}],"responses":{"200":{"description":"与 /v1/map/{layer}/{z}/{x}/{y} 完全等价","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tiles/{layer}/tilejson.json":{"get":{"tags":["map-alias"],"summary":"TileJSON 短别名","operationId":"tiles_alias_tilejson_tiles__layer__tilejson_json_get","parameters":[{"name":"layer","in":"path","required":true,"schema":{"type":"string","title":"Layer"}},{"name":"apikey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。","title":"Apikey"},"description":"API Key（也可放在 Authorization: Bearer）。海图接口还需有效订阅。"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/login":{"post":{"tags":["admin"],"summary":"Admin Login","description":"管理员登录。","operationId":"admin_login_admin_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/dashboard":{"get":{"tags":["admin"],"summary":"Get Dashboard","description":"仪表盘数据。","operationId":"get_dashboard_admin_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Dashboard Admin Dashboard Get"}}}}}}},"/admin/sources":{"get":{"tags":["admin"],"summary":"List Sources","description":"数据源列表。","operationId":"list_sources_admin_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Sources Admin Sources Get"}}}}}},"post":{"tags":["admin"],"summary":"Create Source","description":"新增数据源（登记静态元数据）。\n\n只登记元数据：真正的下载由 scheduler/jobs.py 里的同名下载器执行，\n没有下载器时该源作为登记项存在，has_downloader=False，前端会禁用「手动下载」。","operationId":"create_source_admin_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceUpsertRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Source Admin Sources Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/sources/{source_id}":{"put":{"tags":["admin"],"summary":"Update Source","description":"修改数据源元数据。\n\n标识名不可改：它是下载任务与变量映射的关联键，改名会让历史记录指向空。","operationId":"update_source_admin_sources__source_id__put","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"integer","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceUpsertRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Source Admin Sources  Source Id  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete Source","description":"删除数据源。\n\n内置源不能删（启动种子会重建）；已经产生下载任务/变量映射/优先级记录的源\n也不能删，否则这些行会指向不存在的数据源。","operationId":"delete_source_admin_sources__source_id__delete","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"integer","title":"Source Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Source Admin Sources  Source Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/sources/{source_id}/refresh":{"post":{"tags":["admin"],"summary":"Refresh Source","description":"手动触发数据源下载。","operationId":"refresh_source_admin_sources__source_id__refresh_post","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"integer","title":"Source Id"}},{"name":"force","in":"query","required":false,"schema":{"type":"boolean","description":"强制全量重下，忽略已有 Zarr","default":false,"title":"Force"},"description":"强制全量重下，忽略已有 Zarr"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Refresh Source Admin Sources  Source Id  Refresh Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/sources/{source_id}/stats":{"get":{"tags":["admin"],"summary":"Source Stats","description":"数据源统计。","operationId":"source_stats_admin_sources__source_id__stats_get","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"integer","title":"Source Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Source Stats Admin Sources  Source Id  Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/variables":{"get":{"tags":["admin"],"summary":"List Variables","description":"所有已注册变量列表（仅统计已启用映射）。","operationId":"list_variables_admin_variables_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Variables Admin Variables Get"}}}}}}},"/admin/variables/mapping":{"get":{"tags":["admin"],"summary":"Get Variable Mappings","description":"变量映射详情（默认只返回已启用、已接入数据源的映射）。","operationId":"get_variable_mappings_admin_variables_mapping_get","parameters":[{"name":"unified_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unified Name"}},{"name":"include_inactive","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Inactive"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Variable Mappings Admin Variables Mapping Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/variables/{unified_name}/mapping":{"put":{"tags":["admin"],"summary":"Update Variable Mapping","description":"更新变量映射。","operationId":"update_variable_mapping_admin_variables__unified_name__mapping_put","parameters":[{"name":"unified_name","in":"path","required":true,"schema":{"type":"string","title":"Unified Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Variable Mapping Admin Variables  Unified Name  Mapping Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/variables/mapping/test":{"post":{"tags":["admin"],"summary":"Test Variable Mapping","description":"测试变量映射是否有效。\n\n已启用映射按别名对齐 data_sources；未接入源（如 ecmwf025）不会出现在\n默认列表里。返回每条的 status: ok / no_data / not_configured / inactive。","operationId":"test_variable_mapping_admin_variables_mapping_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingTestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Test Variable Mapping Admin Variables Mapping Test Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/variables/derived":{"get":{"tags":["admin"],"summary":"List Derived Variables","description":"衍生变量列表及计算规则。","operationId":"list_derived_variables_admin_variables_derived_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Derived Variables Admin Variables Derived Get"}}}}}}},"/admin/source-priority":{"get":{"tags":["admin"],"summary":"Get Source Priority","description":"数据源优先级配置。","operationId":"get_source_priority_admin_source_priority_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Get Source Priority Admin Source Priority Get"}}}}}},"put":{"tags":["admin"],"summary":"Update Source Priority","description":"更新数据源优先级。","operationId":"update_source_priority_admin_source_priority_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriorityUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Update Source Priority Admin Source Priority Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/tasks":{"get":{"tags":["admin"],"summary":"List Tasks","description":"下载任务列表（支持分页、筛选）。","operationId":"list_tasks_admin_tasks_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"source_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Source Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Tasks Admin Tasks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/tasks/progress/stream":{"get":{"tags":["admin"],"summary":"Task Progress Stream","description":"下载进度 SSE 流。\n\nEventSource 不能自定义 Authorization，因此支持 ``?access_token=``。","operationId":"task_progress_stream_admin_tasks_progress_stream_get","parameters":[{"name":"access_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"管理员 JWT（EventSource 无法带 Header）","title":"Access Token"},"description":"管理员 JWT（EventSource 无法带 Header）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/tasks/stats":{"get":{"tags":["admin"],"summary":"Task Stats","description":"下载统计。","operationId":"task_stats_admin_tasks_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Task Stats Admin Tasks Stats Get"}}}}}}},"/admin/tasks/{task_id}":{"get":{"tags":["admin"],"summary":"Get Task","description":"单个下载任务详情（含进度）。","operationId":"get_task_admin_tasks__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"integer","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Task Admin Tasks  Task Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/tasks/retry/{task_id}":{"post":{"tags":["admin"],"summary":"Retry Task","description":"重试失败的下载任务。","operationId":"retry_task_admin_tasks_retry__task_id__post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"integer","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Retry Task Admin Tasks Retry  Task Id  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users":{"get":{"tags":["admin"],"summary":"List Users","description":"用户列表（可按审批状态筛选，status=pending 即待审批队列）。","operationId":"list_users_admin_users_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Users Admin Users Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}":{"get":{"tags":["admin"],"summary":"Get User","description":"用户详情。","operationId":"get_user_admin_users__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get User Admin Users  User Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete User","description":"删除用户及其关联数据。\n\n必须先清 ``api_call_logs``（外键指向 ``api_keys``），再删密钥与用户；\n全程用 Core ``delete()``，避免 ORM relationship 再次按主键删 key 触发 1451。","operationId":"delete_user_admin_users__user_id__delete","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete User Admin Users  User Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/approve":{"post":{"tags":["admin"],"summary":"Approve User","description":"审批通过注册申请，并赠送调用额度。\n\n赠送的额度记在 ``credit_calls``（唯一计费余额）上，账号随之变成\napproved，用户无需重新登录即可用原有 API Key 调用。","operationId":"approve_user_admin_users__user_id__approve_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Approve User Admin Users  User Id  Approve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/reject":{"post":{"tags":["admin"],"summary":"Reject User","description":"驳回注册申请，理由会展示给用户。","operationId":"reject_user_admin_users__user_id__reject_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reject User Admin Users  User Id  Reject Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/credit":{"post":{"tags":["admin"],"summary":"Adjust User Credit","description":"把用户剩余额度直接设为指定值（-1 表示不限量）。","operationId":"adjust_user_credit_admin_users__user_id__credit_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditAdjustRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Adjust User Credit Admin Users  User Id  Credit Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orders":{"get":{"tags":["admin"],"summary":"List Recharge Orders","description":"充值订单列表（充值漏斗的后台侧记录）。","operationId":"list_recharge_orders_admin_orders_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Recharge Orders Admin Orders Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/plan":{"put":{"tags":["admin"],"summary":"Update User Plan","description":"修改用户套餐。","operationId":"update_user_plan_admin_users__user_id__plan_put","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update User Plan Admin Users  User Id  Plan Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/disable":{"post":{"tags":["admin"],"summary":"Disable User","description":"禁用用户。","operationId":"disable_user_admin_users__user_id__disable_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Disable User Admin Users  User Id  Disable Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/map/plans":{"get":{"tags":["admin"],"summary":"Admin List Map Plans","operationId":"admin_list_map_plans_admin_map_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Admin List Map Plans Admin Map Plans Get"}}}}}}},"/admin/map/subscriptions":{"get":{"tags":["admin"],"summary":"Admin List Map Subscriptions","operationId":"admin_list_map_subscriptions_admin_map_subscriptions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin List Map Subscriptions Admin Map Subscriptions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/map/users/{user_id}/grant":{"post":{"tags":["admin"],"summary":"Admin Grant Map Subscription","description":"管理员为用户开通/延长海图订阅。","operationId":"admin_grant_map_subscription_admin_map_users__user_id__grant_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapGrantRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Grant Map Subscription Admin Map Users  User Id  Grant Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/map/orders":{"get":{"tags":["admin"],"summary":"Admin List Map Orders","operationId":"admin_list_map_orders_admin_map_orders_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin List Map Orders Admin Map Orders Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/storage":{"get":{"tags":["admin"],"summary":"Storage Stats","description":"存储统计：Zarr / GRIB / 离线地图 MBTiles。","operationId":"storage_stats_admin_storage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Storage Stats Admin Storage Get"}}}}}}},"/admin/storage/expiry":{"get":{"tags":["admin"],"summary":"Storage Expiry","description":"数据到期预览。","operationId":"storage_expiry_admin_storage_expiry_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Storage Expiry Admin Storage Expiry Get"}}}}}}}},"components":{"schemas":{"AdminLoginRequest":{"properties":{"username":{"type":"string","title":"Username","description":"管理员用户名"},"password":{"type":"string","title":"Password","description":"管理员密码"}},"type":"object","required":["username","password"],"title":"AdminLoginRequest","description":"管理员登录请求。"},"AdminLoginResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In"}},"type":"object","required":["access_token","expires_in"],"title":"AdminLoginResponse","description":"管理员登录响应。"},"ApiKeyCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"密钥名称"}},"type":"object","title":"ApiKeyCreate","description":"创建 API Key 请求。"},"ApiKeyResponse":{"properties":{"id":{"type":"integer","title":"Id"},"key":{"type":"string","title":"Key"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","key","name","is_active","created_at","last_used_at"],"title":"ApiKeyResponse","description":"API Key 响应。"},"ApproveRequest":{"properties":{"credits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits","description":"赠送额度，留空用默认免费额度；-1 表示不限量"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan","description":"开通套餐，留空保持 free"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"审批备注"}},"type":"object","title":"ApproveRequest","description":"审批通过请求。"},"BatchQueryRequest":{"properties":{"ships":{"items":{"$ref":"#/components/schemas/ShipPosition"},"type":"array","maxItems":100,"minItems":1,"title":"Ships"},"hours":{"type":"integer","maximum":168.0,"minimum":1.0,"title":"Hours","description":"预报时长（小时）","default":48}},"type":"object","required":["ships"],"title":"BatchQueryRequest","description":"批量查询请求体。"},"CallLogInfo":{"properties":{"id":{"type":"integer","title":"Id"},"endpoint":{"type":"string","title":"Endpoint"},"method":{"type":"string","title":"Method"},"status_code":{"type":"integer","title":"Status Code"},"response_time_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Time Ms"},"called_at":{"type":"string","title":"Called At"}},"type":"object","required":["id","endpoint","method","status_code","called_at"],"title":"CallLogInfo","description":"一条接口调用记录。"},"CallLogsResponse":{"properties":{"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/CallLogInfo"},"type":"array","title":"Items"}},"type":"object","required":["count","items"],"title":"CallLogsResponse","description":"调用记录列表。"},"CreditAdjustRequest":{"properties":{"credits":{"type":"integer","title":"Credits","description":"调整为剩余额度（>=0），传 -1 表示不限量"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"调整备注"}},"type":"object","required":["credits"],"title":"CreditAdjustRequest","description":"调整额度请求。"},"DailyUsagePoint":{"properties":{"date":{"type":"string","title":"Date"},"calls":{"type":"integer","title":"Calls"},"success":{"type":"integer","title":"Success"},"failed":{"type":"integer","title":"Failed"}},"type":"object","required":["date","calls","success","failed"],"title":"DailyUsagePoint","description":"某一天的调用量。"},"DailyUsageResponse":{"properties":{"days":{"type":"integer","title":"Days"},"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/DailyUsagePoint"},"type":"array","title":"Items"}},"type":"object","required":["days","total","items"],"title":"DailyUsageResponse","description":"最近若干天的调用量趋势。"},"DataSourceUpsertRequest":{"properties":{"name":{"type":"string","title":"Name","default":""},"display_name":{"type":"string","title":"Display Name","default":""},"source_type":{"type":"string","title":"Source Type","default":"atmosphere"},"grid_type":{"type":"string","title":"Grid Type","default":"regular"},"resolution":{"type":"number","title":"Resolution","default":0.25},"dt_seconds":{"type":"integer","title":"Dt Seconds","default":21600},"update_interval_seconds":{"type":"integer","title":"Update Interval Seconds","default":21600},"runs_per_day":{"type":"integer","title":"Runs Per Day","default":4},"url_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Template"},"idx_url_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idx Url Template"},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","title":"DataSourceUpsertRequest","description":"新增/修改数据源的静态元数据。"},"ForecastResponse":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"generationtime_ms":{"type":"number","title":"Generationtime Ms"},"utc_offset_seconds":{"type":"integer","title":"Utc Offset Seconds"},"timezone":{"type":"string","title":"Timezone"},"hourly":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Hourly"},"daily":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Daily"},"current":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Current"}},"type":"object","required":["latitude","longitude","generationtime_ms","utc_offset_seconds","timezone"],"title":"ForecastResponse","description":"天气预报响应。"},"GeoSearchResponse":{"properties":{"query":{"type":"string","title":"Query"},"count":{"type":"integer","title":"Count"},"results":{"items":{"$ref":"#/components/schemas/PlaceInfo"},"type":"array","title":"Results"}},"type":"object","required":["query","count","results"],"title":"GeoSearchResponse","description":"地名检索响应。"},"GridResponse":{"properties":{"bbox":{"items":{"type":"number"},"type":"array","title":"Bbox"},"resolution":{"type":"number","title":"Resolution"},"nx":{"type":"integer","title":"Nx"},"ny":{"type":"integer","title":"Ny"},"time":{"type":"string","title":"Time"},"data_source":{"type":"string","title":"Data Source"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"data_status":{"type":"string","title":"Data Status","description":"current / stale"}},"type":"object","required":["bbox","resolution","nx","ny","time","data_source","data","data_status"],"title":"GridResponse","description":"区域网格响应。"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"uptime_seconds":{"type":"number","title":"Uptime Seconds"},"data_sources":{"additionalProperties":true,"type":"object","title":"Data Sources"},"storage":{"additionalProperties":true,"type":"object","title":"Storage"}},"type":"object","required":["status","uptime_seconds","data_sources","storage"],"title":"HealthResponse","description":"健康检查响应。"},"LoginRequest":{"properties":{"email":{"type":"string","title":"Email","description":"邮箱"},"password":{"type":"string","title":"Password","description":"密码"}},"type":"object","required":["email","password"],"title":"LoginRequest","description":"用户登录请求。"},"MapGrantRequest":{"properties":{"plan_key":{"type":"string","title":"Plan Key","description":"套餐标识","default":"map_30"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note","description":"备注"}},"type":"object","title":"MapGrantRequest"},"MapOrderCreate":{"properties":{"plan_key":{"type":"string","title":"Plan Key","description":"套餐标识，如 map_30"},"pay_method":{"type":"string","title":"Pay Method","description":"wechat/alipay","default":"wechat"}},"type":"object","required":["plan_key"],"title":"MapOrderCreate"},"MapOrderPay":{"properties":{"trade_no":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trade No"}},"type":"object","title":"MapOrderPay","description":"模拟扫码支付成功。"},"MappingTestRequest":{"properties":{"unified_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unified Name","description":"统一变量名（空=全部）"},"domain_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Name","description":"指定数据源（可选）"}},"type":"object","title":"MappingTestRequest","description":"测试变量映射请求。unified_name 为空时测试全部已启用映射。"},"MappingUpdateRequest":{"properties":{"domain_name":{"type":"string","title":"Domain Name","description":"数据源标识名"},"native_name":{"type":"string","title":"Native Name","description":"数据源原始变量名"}},"type":"object","required":["domain_name","native_name"],"title":"MappingUpdateRequest","description":"更新变量映射请求。"},"MarineResponse":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"generationtime_ms":{"type":"number","title":"Generationtime Ms"},"utc_offset_seconds":{"type":"integer","title":"Utc Offset Seconds"},"timezone":{"type":"string","title":"Timezone"},"hourly":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Hourly"},"daily":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Daily"},"current":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Current"}},"type":"object","required":["latitude","longitude","generationtime_ms","utc_offset_seconds","timezone"],"title":"MarineResponse","description":"海洋数据响应。"},"PhotonAnimationResponse":{"properties":{"layer":{"type":"string","title":"Layer"},"display_name":{"type":"string","title":"Display Name"},"kind":{"type":"string","title":"Kind"},"unit":{"type":"string","title":"Unit"},"data_source":{"type":"string","title":"Data Source"},"grid":{"$ref":"#/components/schemas/PhotonGridGeom"},"lats":{"items":{"type":"number"},"type":"array","title":"Lats"},"lons":{"items":{"type":"number"},"type":"array","title":"Lons"},"style":{"$ref":"#/components/schemas/PhotonStyle"},"frame_count":{"type":"integer","title":"Frame Count"},"times":{"items":{"type":"string"},"type":"array","title":"Times"},"frames":{"items":{"$ref":"#/components/schemas/PhotonFrame"},"type":"array","title":"Frames"},"generationtime_ms":{"type":"number","title":"Generationtime Ms"}},"type":"object","required":["layer","display_name","kind","unit","data_source","grid","lats","lons","style","frame_count","times","frames","generationtime_ms"],"title":"PhotonAnimationResponse","description":"多帧渲染场 —— 网格几何在帧间保持一致，只有数据随时间变化。"},"PhotonComponent":{"properties":{"name":{"type":"string","title":"Name"},"unit":{"type":"string","title":"Unit"},"min":{"type":"number","title":"Min"},"max":{"type":"number","title":"Max"},"data":{"items":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"array","title":"Data","description":"行优先展平，首行在最北、行内自西向东；缺测点为 null"}},"type":"object","required":["name","unit","min","max","data"],"title":"PhotonComponent","description":"一个场分量（矢量层的 u/v/speed，标量层的 value）。"},"PhotonFieldResponse":{"properties":{"layer":{"type":"string","title":"Layer"},"display_name":{"type":"string","title":"Display Name"},"kind":{"type":"string","title":"Kind"},"unit":{"type":"string","title":"Unit"},"time":{"type":"string","title":"Time","description":"实际数据时间（UTC ISO）"},"time_requested":{"type":"string","title":"Time Requested","description":"请求的时间"},"data_source":{"type":"string","title":"Data Source"},"header":{"$ref":"#/components/schemas/PhotonGridHeader"},"lats":{"items":{"type":"number"},"type":"array","title":"Lats","description":"纬度坐标，自北向南"},"lons":{"items":{"type":"number"},"type":"array","title":"Lons","description":"经度坐标，自西向东，与请求区间一致"},"components":{"additionalProperties":{"$ref":"#/components/schemas/PhotonComponent"},"type":"object","title":"Components"},"style":{"$ref":"#/components/schemas/PhotonStyle"},"generationtime_ms":{"type":"number","title":"Generationtime Ms"}},"type":"object","required":["layer","display_name","kind","unit","time","time_requested","data_source","header","lats","lons","components","style","generationtime_ms"],"title":"PhotonFieldResponse","description":"单时刻渲染场。"},"PhotonFrame":{"properties":{"time":{"type":"string","title":"Time"},"components":{"additionalProperties":{"$ref":"#/components/schemas/PhotonComponent"},"type":"object","title":"Components"}},"type":"object","required":["time","components"],"title":"PhotonFrame","description":"动画中的一帧。"},"PhotonGridGeom":{"properties":{"lo1":{"type":"number","title":"Lo1","description":"第一列经度（西边界）"},"la1":{"type":"number","title":"La1","description":"第一行纬度（北边界）"},"lo2":{"type":"number","title":"Lo2","description":"最后一列经度（东边界）"},"la2":{"type":"number","title":"La2","description":"最后一行纬度（南边界）"},"dx":{"type":"number","title":"Dx","description":"经度步长（度）"},"dy":{"type":"number","title":"Dy","description":"纬度步长（度）"},"nx":{"type":"integer","title":"Nx"},"ny":{"type":"integer","title":"Ny"},"scanMode":{"type":"integer","title":"Scanmode","description":"0 = 首行在最北、行内自西向东","default":0}},"type":"object","required":["lo1","la1","lo2","la2","dx","dy","nx","ny"],"title":"PhotonGridGeom","description":"网格几何：描述一帧场的行列布局与步长。"},"PhotonGridHeader":{"properties":{"lo1":{"type":"number","title":"Lo1","description":"第一列经度（西边界）"},"la1":{"type":"number","title":"La1","description":"第一行纬度（北边界）"},"lo2":{"type":"number","title":"Lo2","description":"最后一列经度（东边界）"},"la2":{"type":"number","title":"La2","description":"最后一行纬度（南边界）"},"dx":{"type":"number","title":"Dx","description":"经度步长（度）"},"dy":{"type":"number","title":"Dy","description":"纬度步长（度）"},"nx":{"type":"integer","title":"Nx"},"ny":{"type":"integer","title":"Ny"},"scanMode":{"type":"integer","title":"Scanmode","description":"0 = 首行在最北、行内自西向东","default":0},"refTime":{"type":"string","title":"Reftime","description":"该帧实际数据时间（UTC ISO）"},"parameterCategory":{"type":"integer","title":"Parametercategory"},"parameterNumber":{"type":"integer","title":"Parameternumber"},"parameterUnit":{"type":"string","title":"Parameterunit"}},"type":"object","required":["lo1","la1","lo2","la2","dx","dy","nx","ny","refTime","parameterCategory","parameterNumber","parameterUnit"],"title":"PhotonGridHeader","description":"单帧网格头：几何 + 时间 + GRIB 要素编码。"},"PhotonLayerInfo":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"type":"string","title":"Display Name"},"kind":{"type":"string","title":"Kind","description":"vector（含 U/V 分量）/ scalar（单标量场）"},"unit":{"type":"string","title":"Unit"},"precision":{"type":"integer","title":"Precision"},"description":{"type":"string","title":"Description"},"variables":{"additionalProperties":{"type":"string"},"type":"object","title":"Variables","description":"分量名 → 统一变量名，标量层为 {'value': ...}"},"parameter":{"additionalProperties":{"type":"integer"},"type":"object","title":"Parameter","description":"GRIB2 要素编码 discipline/category/number"},"palette":{"items":{"type":"string"},"type":"array","title":"Palette","description":"建议色带（低值 → 高值）"},"suggested_range":{"items":{"type":"number"},"type":"array","title":"Suggested Range","description":"建议映射值域 [min, max]"},"particle":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Particle","description":"矢量层的粒子动画建议参数"},"data_available":{"type":"boolean","title":"Data Available"},"data_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Source"},"time_count":{"type":"integer","title":"Time Count","default":0},"latest_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Time"}},"type":"object","required":["id","display_name","kind","unit","precision","description","variables","parameter","palette","suggested_range","data_available"],"title":"PhotonLayerInfo","description":"单个渲染图层的定义与可用状态。"},"PhotonLayersResponse":{"properties":{"count":{"type":"integer","title":"Count"},"layers":{"items":{"$ref":"#/components/schemas/PhotonLayerInfo"},"type":"array","title":"Layers"}},"type":"object","required":["count","layers"],"title":"PhotonLayersResponse","description":"图层目录响应。"},"PhotonStyle":{"properties":{"palette":{"items":{"type":"string"},"type":"array","title":"Palette"},"suggested_range":{"items":{"type":"number"},"type":"array","title":"Suggested Range"},"particle":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Particle"}},"type":"object","required":["palette","suggested_range"],"title":"PhotonStyle","description":"渲染建议 —— 服务端不绘图，只给前端统一的配色与粒子参数。"},"PhotonTimesResponse":{"properties":{"layer":{"type":"string","title":"Layer"},"display_name":{"type":"string","title":"Display Name"},"kind":{"type":"string","title":"Kind"},"data_source":{"type":"string","title":"Data Source"},"count":{"type":"integer","title":"Count"},"first":{"type":"string","title":"First"},"latest":{"type":"string","title":"Latest"},"times":{"items":{"type":"string"},"type":"array","title":"Times"}},"type":"object","required":["layer","display_name","kind","data_source","count","first","latest","times"],"title":"PhotonTimesResponse","description":"图层的可选时刻列表。"},"PlaceInfo":{"properties":{"name":{"type":"string","title":"Name"},"full_name":{"type":"string","title":"Full Name"},"kind":{"type":"string","title":"Kind","description":"city / port / sea / island / station"},"admin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin"},"country":{"type":"string","title":"Country"},"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"distance_km":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distance Km","description":"按坐标反查时给出的球面距离（公里）"}},"type":"object","required":["name","full_name","kind","country","latitude","longitude"],"title":"PlaceInfo","description":"一个地名条目。"},"PlanUpdateRequest":{"properties":{"plan":{"type":"string","title":"Plan","description":"套餐: free/basic/pro/enterprise"}},"type":"object","required":["plan"],"title":"PlanUpdateRequest","description":"修改用户套餐请求。"},"PriorityUpdateRequest":{"properties":{"priorities":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Priorities","description":"优先级列表 [{variable_name, domain_name, priority}]"}},"type":"object","required":["priorities"],"title":"PriorityUpdateRequest","description":"更新优先级请求。"},"QuotaResponse":{"properties":{"plan":{"type":"string","title":"Plan"},"status":{"type":"string","title":"Status"},"credit_calls":{"type":"integer","title":"Credit Calls","description":"剩余可调用次数（-1 不限量）"},"granted_calls":{"type":"integer","title":"Granted Calls","description":"累计获得额度"},"used_calls":{"type":"integer","title":"Used Calls","description":"累计已用额度"},"remaining_ratio":{"type":"number","title":"Remaining Ratio","description":"剩余额度占比 0~1，不限量时为 1"},"unlimited":{"type":"boolean","title":"Unlimited"},"daily_quota":{"type":"integer","title":"Daily Quota"},"today_calls":{"type":"integer","title":"Today Calls"},"month_calls":{"type":"integer","title":"Month Calls"},"last_call_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Call At"}},"type":"object","required":["plan","status","credit_calls","granted_calls","used_calls","remaining_ratio","unlimited","daily_quota","today_calls","month_calls"],"title":"QuotaResponse","description":"额度与用量快照 —— 用户中心的额度面板直接绑定这个结构。"},"RechargeChannel":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"note":{"type":"string","title":"Note"}},"type":"object","required":["id","name","note"],"title":"RechargeChannel","description":"一种扫码支付渠道。"},"RechargeOrderCreate":{"properties":{"package_id":{"type":"string","title":"Package Id","description":"套餐标识"},"pay_method":{"type":"string","title":"Pay Method","description":"支付渠道: wechat/alipay","default":"wechat"}},"type":"object","required":["package_id"],"title":"RechargeOrderCreate","description":"创建充值订单请求。"},"RechargeOrderInfo":{"properties":{"order_no":{"type":"string","title":"Order No"},"package_id":{"type":"string","title":"Package Id"},"package_name":{"type":"string","title":"Package Name"},"amount_cents":{"type":"integer","title":"Amount Cents"},"amount_display":{"type":"string","title":"Amount Display"},"credits":{"type":"integer","title":"Credits"},"credits_display":{"type":"string","title":"Credits Display"},"plan":{"type":"string","title":"Plan"},"pay_method":{"type":"string","title":"Pay Method"},"pay_method_name":{"type":"string","title":"Pay Method Name"},"pay_url":{"type":"string","title":"Pay Url","description":"二维码承载的支付串"},"qr_svg":{"type":"string","title":"Qr Svg","description":"支付二维码（内联 SVG）"},"status":{"type":"string","title":"Status","description":"pending/paid/expired/cancelled"},"trade_no":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trade No"},"created_at":{"type":"string","title":"Created At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"paid_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paid At"},"credited_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credited At"},"credit_calls_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credit Calls After","description":"支付成功后的剩余额度"}},"type":"object","required":["order_no","package_id","package_name","amount_cents","amount_display","credits","credits_display","plan","pay_method","pay_method_name","pay_url","qr_svg","status","created_at"],"title":"RechargeOrderInfo","description":"充值订单（含二维码）。"},"RechargeOrdersResponse":{"properties":{"count":{"type":"integer","title":"Count"},"paid_count":{"type":"integer","title":"Paid Count"},"total_amount_cents":{"type":"integer","title":"Total Amount Cents"},"items":{"items":{"$ref":"#/components/schemas/RechargeOrderInfo"},"type":"array","title":"Items"}},"type":"object","required":["count","paid_count","total_amount_cents","items"],"title":"RechargeOrdersResponse","description":"充值订单列表。"},"RechargePackageInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"price_cents":{"type":"integer","title":"Price Cents"},"price_display":{"type":"string","title":"Price Display"},"credits":{"type":"integer","title":"Credits","description":"到账额度（-1 不限量）"},"credits_display":{"type":"string","title":"Credits Display"},"plan":{"type":"string","title":"Plan"},"description":{"type":"string","title":"Description"},"badge":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Badge"}},"type":"object","required":["id","name","price_cents","price_display","credits","credits_display","plan","description"],"title":"RechargePackageInfo","description":"一个充值套餐。"},"RechargePackagesResponse":{"properties":{"count":{"type":"integer","title":"Count"},"packages":{"items":{"$ref":"#/components/schemas/RechargePackageInfo"},"type":"array","title":"Packages"},"channels":{"items":{"$ref":"#/components/schemas/RechargeChannel"},"type":"array","title":"Channels"},"free_trial_credits":{"type":"integer","title":"Free Trial Credits","description":"审批通过赠送的免费额度"},"trial_account_credits":{"type":"integer","title":"Trial Account Credits","description":"免审批体验账号额度"}},"type":"object","required":["count","packages","channels","free_trial_credits","trial_account_credits"],"title":"RechargePackagesResponse","description":"充值套餐目录。"},"RegisterRequest":{"properties":{"email":{"type":"string","title":"Email","description":"邮箱"},"password":{"type":"string","minLength":6,"title":"Password","description":"密码（至少6位）"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"用户名称"}},"type":"object","required":["email","password"],"title":"RegisterRequest","description":"用户注册请求。"},"RegisterResponse":{"properties":{"user_id":{"type":"integer","title":"User Id"},"email":{"type":"string","title":"Email"},"status":{"type":"string","title":"Status","description":"审批状态: pending/approved/rejected"},"message":{"type":"string","title":"Message"},"credit_calls":{"type":"integer","title":"Credit Calls","description":"当前剩余可调用次数"},"granted_calls":{"type":"integer","title":"Granted Calls","description":"已赠送额度（审批通过后到账）"},"api_key":{"type":"string","title":"Api Key","description":"默认 API Key（仅此处返回完整值）"},"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In","default":86400}},"type":"object","required":["user_id","email","status","message","credit_calls","granted_calls","api_key","access_token"],"title":"RegisterResponse","description":"注册响应 —— 账号默认进入待审批状态。"},"RejectRequest":{"properties":{"reason":{"type":"string","title":"Reason","description":"驳回原因","default":"资料不符合要求"}},"type":"object","title":"RejectRequest","description":"审批驳回请求。"},"ShipPosition":{"properties":{"id":{"type":"string","title":"Id","description":"船舶标识"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"}},"type":"object","required":["id","latitude","longitude"],"title":"ShipPosition","description":"单船查询请求体。"},"TokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in":{"type":"integer","title":"Expires In","default":86400}},"type":"object","required":["access_token"],"title":"TokenResponse","description":"JWT Token 响应。"},"UserInfo":{"properties":{"id":{"type":"integer","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"plan":{"type":"string","title":"Plan"},"api_key_count":{"type":"integer","title":"Api Key Count"},"created_at":{"type":"string","title":"Created At"},"status":{"type":"string","title":"Status","description":"审批状态: pending/approved/rejected","default":"approved"},"source":{"type":"string","title":"Source","description":"开户来源: register/trial","default":"register"},"credit_calls":{"type":"integer","title":"Credit Calls","description":"剩余可调用次数（-1 不限量）","default":0},"granted_calls":{"type":"integer","title":"Granted Calls","description":"累计获得额度","default":0},"daily_quota":{"type":"integer","title":"Daily Quota","description":"每日调用上限（-1 不限量）","default":0},"review_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Note"},"reviewed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewed At"}},"type":"object","required":["id","email","name","plan","api_key_count","created_at"],"title":"UserInfo","description":"用户信息。"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"health","description":"健康检查"},{"name":"forecast","description":"天气预报"},{"name":"marine","description":"海洋要素"},{"name":"tide","description":"潮汐预报"},{"name":"typhoon","description":"台风路径"},{"name":"ship","description":"船舶相关"},{"name":"grid","description":"区域网格"},{"name":"photon","description":"光子场可视化"},{"name":"geo","description":"地理检索"},{"name":"auth","description":"用户注册 / 登录 / API Key"},{"name":"recharge","description":"气象额度充值"},{"name":"map","description":"离线海图瓦片与元数据（需 API Key + 海图订阅）。瓦片 URL 可在 Query 带 `apikey=`，或 Header `Authorization: Bearer <key>`。"},{"name":"map-alias","description":"海图短别名 `/tiles/...`，与 `/v1/map/...` 等价。"},{"name":"map-billing","description":"海图订阅套餐、当前订阅、下单支付（与气象 credit_calls 隔离）。"},{"name":"admin","description":"管理后台 API（管理员 JWT）"}]}