{"openapi":"3.0.3","info":{"title":"Xiake Agent API","version":"1.0.0","description":"霞客 Agent 接口：forecast / explain / geocode（需 token 鉴权），用于火烧云预报与地理位置解析。"},"servers":[{"url":"/api"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Token"}}},"security":[{"bearerAuth":[]}],"paths":{"/api/agent/forecast":{"get":{"summary":"火烧云预测","parameters":[{"in":"query","name":"lat","required":false,"schema":{"type":"number","minimum":-90,"maximum":90}},{"in":"query","name":"lon","required":false,"schema":{"type":"number","minimum":-180,"maximum":180}},{"in":"query","name":"location","required":false,"schema":{"type":"string"}},{"in":"query","name":"type","required":false,"schema":{"type":"string","enum":["sunrise","sunset"]}},{"in":"query","name":"date","required":false,"schema":{"type":"string"}},{"in":"query","name":"detail","required":false,"schema":{"type":"string","enum":["simple","full"]}}],"responses":{"200":{"description":"OK"},"400":{"description":"请求参数错误"},"401":{"description":"鉴权失败"},"403":{"description":"权限不足/配额"},"429":{"description":"配额超限"},"500":{"description":"服务错误"}}}},"/api/agent/explain":{"get":{"summary":"解释性预测","parameters":[{"in":"query","name":"lat","required":false,"schema":{"type":"number","minimum":-90,"maximum":90}},{"in":"query","name":"lon","required":false,"schema":{"type":"number","minimum":-180,"maximum":180}},{"in":"query","name":"location","required":false,"schema":{"type":"string"}},{"in":"query","name":"type","required":false,"schema":{"type":"string","enum":["sunrise","sunset"]}},{"in":"query","name":"date","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"请求参数错误"},"401":{"description":"鉴权失败"},"403":{"description":"权限不足/配额"},"429":{"description":"配额超限"},"500":{"description":"服务错误"}}}},"/api/agent/geocode":{"get":{"summary":"地理编码","parameters":[{"in":"query","name":"q","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"OK"},"400":{"description":"请求参数错误"},"401":{"description":"鉴权失败"},"403":{"description":"权限不足/配额"},"404":{"description":"未找到地点"},"429":{"description":"配额超限"},"500":{"description":"服务错误"}}}},"/api/agent/map-summary":{"get":{"summary":"区域火烧云地图摘要","parameters":[{"in":"query","name":"bbox","required":false,"schema":{"type":"string","description":"west,south,east,north"}},{"in":"query","name":"type","required":false,"schema":{"type":"string","enum":["sunrise","sunset"]}},{"in":"query","name":"threshold","required":false,"schema":{"type":"number","minimum":0,"maximum":100}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"OK"},"400":{"description":"请求参数错误"},"401":{"description":"鉴权失败"},"403":{"description":"权限不足/配额"},"429":{"description":"配额超限"},"500":{"description":"服务错误"},"503":{"description":"地图缓存未就绪"}}}}}}