{"openapi":"3.0.3","info":{"title":"教学培训二部记账小助手（扣子插件）","version":"1.0","description":"只读财务数据查询接口。请把 servers.url 替换为你的公网 HTTPS 地址，并在扣子插件配置中选择「API Key」认证，请求头 X-API-Key 填写系统设置中配置的密钥。"},"servers":[{"url":"https://你的域名:8000"}],"paths":{"/api/coze/health":{"get":{"summary":"健康检查","operationId":"api_coze_health","tags":["扣子插件"],"parameters":[],"responses":{"200":{"description":"成功"},"401":{"description":"API Key 无效"},"403":{"description":"未配置 API Key"}}}},"/api/coze/categories":{"get":{"summary":"板块列表","operationId":"api_coze_categories","tags":["扣子插件"],"parameters":[],"responses":{"200":{"description":"成功"},"401":{"description":"API Key 无效"},"403":{"description":"未配置 API Key"}}}},"/api/coze/summary":{"get":{"summary":"财务看板月度汇总（支出、同比环比、板块/归口占比、预算执行、待办数量）","operationId":"api_coze_summary","tags":["扣子插件"],"parameters":[{"name":"month","in":"query","required":false,"schema":{"type":"string"},"description":"统计月份 YYYY-MM，留空为当月"}],"responses":{"200":{"description":"成功"},"401":{"description":"API Key 无效"},"403":{"description":"未配置 API Key"}}}},"/api/coze/trend":{"get":{"summary":"近N个月支出趋势（含去年同比）","operationId":"api_coze_trend","tags":["扣子插件"],"parameters":[{"name":"months","in":"query","required":false,"schema":{"type":"integer","default":12},"description":"月份数，默认12"}],"responses":{"200":{"description":"成功"},"401":{"description":"API Key 无效"},"403":{"description":"未配置 API Key"}}}},"/api/coze/breakdown":{"get":{"summary":"支出/需求穿透明细","operationId":"api_coze_breakdown","tags":["扣子插件"],"parameters":[{"name":"month","in":"query","required":false,"schema":{"type":"string"},"description":"统计月份 YYYY-MM"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"板块 key"},{"name":"center","in":"query","required":false,"schema":{"type":"string"},"description":"归口"},{"name":"kind","in":"query","required":false,"schema":{"type":"string"},"description":"paid/approved"},{"name":"kw","in":"query","required":false,"schema":{"type":"string"},"description":"关键词"}],"responses":{"200":{"description":"成功"},"401":{"description":"API Key 无效"},"403":{"description":"未配置 API Key"}}}},"/api/coze/demands":{"get":{"summary":"查询需求单列表","operationId":"api_coze_demands","tags":["扣子插件"],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string"},"description":"状态"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"板块 key"},{"name":"center","in":"query","required":false,"schema":{"type":"string"},"description":"归口"},{"name":"kw","in":"query","required":false,"schema":{"type":"string"},"description":"关键词"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"页码"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"每页条数"}],"responses":{"200":{"description":"成功"},"401":{"description":"API Key 无效"},"403":{"description":"未配置 API Key"}}}},"/api/coze/reimbursements":{"get":{"summary":"查询报销单列表","operationId":"api_coze_reimbursements","tags":["扣子插件"],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string"},"description":"状态"},{"name":"kw","in":"query","required":false,"schema":{"type":"string"},"description":"关键词"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"板块 key"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"页码"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"每页条数"}],"responses":{"200":{"description":"成功"},"401":{"description":"API Key 无效"},"403":{"description":"未配置 API Key"}}}},"/api/coze/manual-entries":{"get":{"summary":"查询手工录入历史数据","operationId":"api_coze_manual-entries","tags":["扣子插件"],"parameters":[{"name":"month","in":"query","required":false,"schema":{"type":"string"},"description":"归属月份 YYYY-MM"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"页码"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"每页条数"}],"responses":{"200":{"description":"成功"},"401":{"description":"API Key 无效"},"403":{"description":"未配置 API Key"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"security":[{"ApiKeyAuth":[]}]}