{"openapi":"3.1.0","info":{"title":"股票数据API服务平台","description":"股票数据API服务平台 - 付费订阅","version":"2.0.0"},"paths":{"/":{"get":{"tags":["公开页面"],"summary":"Page Home","operationId":"page_home__get","responses":{"200":{"description":"Successful Response"}}}},"/pricing":{"get":{"tags":["公开页面"],"summary":"Page Pricing","operationId":"page_pricing_pricing_get","responses":{"200":{"description":"Successful Response"}}}},"/changelog":{"get":{"tags":["公开页面"],"summary":"Page Changelog","description":"更新日志: 商用数据服务的信任件 —— 变更可追溯(契约调整/定价/新接口都留痕)","operationId":"page_changelog_changelog_get","responses":{"200":{"description":"Successful Response"}}}},"/docs":{"get":{"tags":["公开页面"],"summary":"Page Docs","description":"文档首页: 使用指南(快速开始/约定/配额/错误码/迁移) + 接口分组目录\n\n端点契约不在此页堆砌 —— 每个端点独立成页 /docs/{mkt}/{ep_id}(可随接口扩容)。","operationId":"page_docs_docs_get","responses":{"200":{"description":"Successful Response"}}}},"/docs/{mkt}/{ep_id}":{"get":{"tags":["公开页面"],"summary":"Page Doc Endpoint","description":"端点详情页(独立URL, SEO长尾): 契约表/示例随 api_doc 权威表实时生效\n\nURL 市场前缀化(2026-10-11): /docs/a/day ↔ /api/a/stock/day_kline 同构;\ndoc_id = {mkt}_{ep_id}; 二期港美 /docs/hk/day、/docs/us/day 自然扩展。","operationId":"page_doc_endpoint_docs__mkt___ep_id__get","parameters":[{"name":"mkt","in":"path","required":true,"schema":{"type":"string","title":"Mkt"}},{"name":"ep_id","in":"path","required":true,"schema":{"type":"string","title":"Ep Id"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/terms":{"get":{"tags":["公开页面"],"summary":"Page Terms","operationId":"page_terms_terms_get","responses":{"200":{"description":"Successful Response"}}}},"/privacy":{"get":{"tags":["公开页面"],"summary":"Page Privacy","operationId":"page_privacy_privacy_get","responses":{"200":{"description":"Successful Response"}}}},"/disclaimer":{"get":{"tags":["公开页面"],"summary":"Page Disclaimer","operationId":"page_disclaimer_disclaimer_get","responses":{"200":{"description":"Successful Response"}}}},"/a-share-data-api":{"get":{"tags":["公开页面"],"summary":"Page A Share Api","description":"SEO 关键词落地页: A股数据API/股票数据接口(2026-10-02 上线准备)","operationId":"page_a_share_api_a_share_data_api_get","responses":{"200":{"description":"Successful Response"}}}},"/stock-data-download":{"get":{"tags":["公开页面"],"summary":"Page Stock Data Download","description":"SEO 关键词落地页: A股历史数据下载/批量获取(2026-10-03 P2增长)","operationId":"page_stock_data_download_stock_data_download_get","responses":{"200":{"description":"Successful Response"}}}},"/quant-data-api":{"get":{"tags":["公开页面"],"summary":"Page Quant Data Api","description":"SEO 关键词落地页: 量化数据接口/回测数据(2026-10-03 P2增长)","operationId":"page_quant_data_api_quant_data_api_get","responses":{"200":{"description":"Successful Response"}}}},"/ai-agents":{"get":{"tags":["公开页面"],"summary":"Page Ai Agents","description":"AI Agent 接入指南(SEO + 新客群入口): MCP / SDK / REST 三种姿势给 Agent 用","operationId":"page_ai_agents_ai_agents_get","responses":{"200":{"description":"Successful Response"}}}},"/stock/{code}":{"get":{"tags":["公开页面"],"summary":"Page Stock","description":"个股行情页: 名称/最新行情摘要 + 近30日日线表 + JSON-LD\n\n数据异常不炸页面(logger告警后降级为仅基本信息);\n无名称且无行情 → 404(不给搜索引擎产出空壳页)。","operationId":"page_stock_stock__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/robots.txt":{"get":{"tags":["公开页面"],"summary":"Robots Txt","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"tags":["公开页面"],"summary":"Llms Txt","description":"llms.txt 约定(_llms.txt 规范): 给 LLM/Agent 的站点导读 — 纯文本, 无需JS","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/sitemap.xml":{"get":{"tags":["公开页面"],"summary":"Sitemap Index","description":"sitemap索引: 静态页 + 股票分页sitemap","operationId":"sitemap_index_sitemap_xml_get","responses":{"200":{"description":"Successful Response"}}}},"/sitemap-pages.xml":{"get":{"tags":["公开页面"],"summary":"Sitemap Pages","operationId":"sitemap_pages_sitemap_pages_xml_get","responses":{"200":{"description":"Successful Response"}}}},"/sitemap-stocks-{page}.xml":{"get":{"tags":["公开页面"],"summary":"Sitemap Stocks","description":"个股URL分页sitemap(股票类型; 每页1万条)","operationId":"sitemap_stocks_sitemap_stocks__page__xml_get","parameters":[{"name":"page","in":"path","required":true,"schema":{"type":"integer","title":"Page"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/wechat/config":{"get":{"tags":["注册登录"],"summary":"Wechat Config","description":"扫码登录可用性 + 前端选路参数\n\nmode 决定前端渲染哪条通道:\n  miniprogram → 调 POST /wechat/qrcode 拿小程序码并轮询 status\n  website     → 内嵌官方 WxLogin(用 appid/redirect_uri)\n  none        → 隐藏扫码入口, 直接落到邮箱登录(本地开发的降级路径)","operationId":"wechat_config_api_auth_wechat_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/auth/wechat/login":{"post":{"tags":["注册登录"],"summary":"Wechat Login","description":"扫码授权码 → 登录态 / 绑定票据 —— 「网站应用」通道专用\n\n扫码是唯一登录方式(2026-10-11): openid 已绑定 → 直接发网页轨 token;\n未绑定 → 不再自动建号, 返回 need_bind + 短时效绑定票据, 前端弹\n「邮箱+密码」表单提交到 /wechat/bind 完成注册或绑定。","operationId":"wechat_login_api_auth_wechat_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/wechat/bind":{"post":{"tags":["注册登录"],"summary":"Wechat Bind","description":"凭绑定票据 + 邮箱密码完成绑定/注册(未绑定微信的唯一进账号路径)\n\n库里无该邮箱 → 注册+绑定; 已注册且未绑微信且验密通过 → 绑定;\n密码错/已绑其他微信 → 400(表单可改后重试)。成功即发网页轨 token。","operationId":"wechat_bind_api_auth_wechat_bind_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatBindRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/wechat/qrcode":{"post":{"tags":["注册登录"],"summary":"Wechat Qrcode","description":"生成一次性 scene + 对应小程序码(data URL), 供 PC 端展示","operationId":"wechat_qrcode_api_auth_wechat_qrcode_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/QrcodeRequest"},{"type":"null"}],"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/wechat/qrcode/status":{"get":{"tags":["注册登录"],"summary":"Wechat Qrcode Status","description":"PC 端短轮询扫码结果: expired / pending / ok(附登录态)","operationId":"wechat_qrcode_status_api_auth_wechat_qrcode_status_get","parameters":[{"name":"scene","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":32,"title":"Scene"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/wechat/mini/confirm":{"post":{"tags":["注册登录"],"summary":"Wechat Mini Confirm","description":"小程序端回调: scene + wx.login 的 code → 完成 PC 端登录\n\n调用方是微信小程序(非浏览器)。三种回执:\n  ok          → 成功(只回执结果, 登录态/明文Key留在 scene 里由 PC 轮询取走)\n  need_bind   → 微信未绑定账号, 小程序弹绑定表单(带出码烙进来的邀请码)\n  client_error→ 表单可修正错误(密码错/邀请码无效), 表单保留可重试","operationId":"wechat_mini_confirm_api_auth_wechat_mini_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MiniConfirmRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/captcha":{"get":{"tags":["注册登录"],"summary":"Get Captcha","description":"注册图形验证码: 一次性, 5 分钟有效, 通过后立即作废","operationId":"get_captcha_api_auth_captcha_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/auth/register":{"post":{"tags":["注册登录"],"summary":"Register","description":"用户注册(2026-10-14 起不再发默认Key, Key由用户在Keys页自建; 需图形验证码防批量注册)","operationId":"register_api_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/refresh":{"post":{"tags":["注册登录"],"summary":"Refresh Session","description":"网页 access 过期 → 凭 refresh 静默换新(access+refresh 双新)\n\n校验失败(验签/过期/类型混淆)一律 401, 前端据此清凭据回登录页。\n账号被停用后 refresh 同样失效 —— 停用即时生效, 不等 access 自然过期。","operationId":"refresh_session_api_auth_refresh_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/login":{"post":{"tags":["注册登录"],"summary":"Login User","description":"用户登录，返回 API Key（需图形验证码，与注册同款一次性校验）\n\n登录限频(10/分/IP)拦的是高频撞库, 验证码拦的是低速人肉/分布式撞库\n—— 两者叠加; 微信扫码通道不适用(微信侧自有人机校验)。","operationId":"login_user_api_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/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/docs":{"get":{"tags":["接口文档"],"summary":"Public Docs","description":"接口文档(分组结构: 组名/组描述/端点列表), 空库自动灌种子","operationId":"public_docs_api_docs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/health/freshness":{"get":{"tags":["数据健康"],"summary":"Get Freshness","description":"数据新鲜度: 各数据表最新日期 vs 应就绪交易日(公开监控端点, 含滞后容差)","operationId":"get_freshness_api_health_freshness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/pay/notify/{provider}":{"post":{"tags":["支付回调"],"summary":"Pay Notify","description":"通道异步回调: 验签失败返回 400(通道会重试), 成功应答 'success'","operationId":"pay_notify_api_pay_notify__provider__post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/pay/mock/{order_no}":{"post":{"tags":["支付回调"],"summary":"Mock Pay","description":"模拟支付成功(联调): 仅 PAY_PROVIDER 显式配为 mock 时可用(缺省≠mock)","operationId":"mock_pay_api_pay_mock__order_no__post","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"}}}}}}},"/api/a/stock/day_kline":{"get":{"tags":["股票数据"],"summary":"Get Day Kline","description":"日线行情: 开高低收 / 成交量额 / 换手率(派生指标与赚钱效应均已移除, 本地自算)\n\nadjust=qfq/hfq 时复权因子覆盖不足(因子表滞后)返回 503, 显式报错不静默错价。\ninclude_today=1: 库内当日行缺失时追加实时当日行(实盘接入, 2026-09-09)。\ndate=单日截面(2026-10-09): 不传code时date=全市场当日行情一次调用;\ncode+date 组合(2026-10-12)=该股该日单根bar(假日探测/单日对账,\n按 start_date=end_date=date 处理)。\n一批股票(≤100码)请用 /api/a/stock/day_batch(一次HTTP往返, 按码数计点)。","operationId":"get_day_kline_api_a_stock_day_kline_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码，支持裸码(000001)或带前缀(sz000001)","title":"Code"},"description":"股票代码，支持裸码(000001)或带前缀(sz000001)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"单日截面模式: 不传code时传date=全市场当日行情(不支持adjust/limit/include_today)","title":"Date"},"description":"单日截面模式: 不传code时传date=全市场当日行情(不支持adjust/limit/include_today)"},{"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":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"起始日期 YYYY-MM-DD(默认全历史)","title":"Start Date"},"description":"起始日期 YYYY-MM-DD(默认全历史)"},{"name":"adjust","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"复权: qfq前复权 / hfq后复权 / None不复权","title":"Adjust"},"description":"复权: qfq前复权 / hfq后复权 / None不复权"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":1},{"type":"null"}],"description":"响应截尾: 只返回区间内最新N根(缺省=不截尾, 全历史返回)","title":"Limit"},"description":"响应截尾: 只返回区间内最新N根(缺省=不截尾, 全历史返回)"},{"name":"include_today","in":"query","required":false,"schema":{"type":"boolean","description":"盘中追加当日实时行(is_realtime标记; 不支持复权)","default":false,"title":"Include Today"},"description":"盘中追加当日实时行(is_realtime标记; 不支持复权)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/day_batch":{"get":{"tags":["股票数据"],"summary":"Get Day Data Batch","description":"批量日线(2026-10-09独立端点): ≤100码一次HTTP往返, 按码数计点(cost=码数)\n\n语义与逐码调用 /api/a/stock/day_kline 完全一致(复权/截尾/实时行), 收益=省N-1次\n往返与鉴权。任一码复权因子覆盖不足仍 503(关键错误不静默降级)。","operationId":"get_day_data_batch_api_a_stock_day_batch_get","parameters":[{"name":"codes","in":"query","required":true,"schema":{"type":"string","description":"批量模式: 逗号分隔≤100码; 每码独立截尾, rows合并(每行含code)","title":"Codes"},"description":"批量模式: 逗号分隔≤100码; 每码独立截尾, rows合并(每行含code)"},{"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":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"起始日期 YYYY-MM-DD(默认全历史)","title":"Start Date"},"description":"起始日期 YYYY-MM-DD(默认全历史)"},{"name":"adjust","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"复权: qfq前复权 / hfq后复权 / None不复权","title":"Adjust"},"description":"复权: qfq前复权 / hfq后复权 / None不复权"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":1},{"type":"null"}],"description":"响应截尾: 每码只返回区间内最新N根(缺省=不截尾)","title":"Limit"},"description":"响应截尾: 每码只返回区间内最新N根(缺省=不截尾)"},{"name":"include_today","in":"query","required":false,"schema":{"type":"boolean","description":"盘中追加当日实时行(is_realtime标记; 不支持复权)","default":false,"title":"Include Today"},"description":"盘中追加当日实时行(is_realtime标记; 不支持复权)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/adjust_factor":{"get":{"tags":["股票数据"],"summary":"Get Adjust Factor","description":"复权因子序列(tushare adj_factor 对位): [{date, factor}]\n量化用户可据因子本地复权任意字段或自定义口径; qfq 最新因子恒为1.0。\n门槛同 /day(L1)。","operationId":"get_adjust_factor_api_a_stock_adjust_factor_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码，支持裸码或带前缀","title":"Code"},"description":"股票代码，支持裸码或带前缀"},{"name":"adjust","in":"query","required":false,"schema":{"type":"string","description":"复权基准: qfq(最新=1) / hfq(上市=1)","default":"qfq","title":"Adjust"},"description":"复权基准: qfq(最新=1) / hfq(上市=1)"},{"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":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":1},{"type":"null"}],"description":"截尾取最新N条(缺省=不截尾)","title":"Limit"},"description":"截尾取最新N条(缺省=不截尾)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/info":{"get":{"tags":["股票数据"],"summary":"Get Stock Info","description":"股票基本信息(名称/市场/类型)","operationId":"get_stock_info_api_a_stock_info_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"description":"股票代码"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/list":{"get":{"tags":["股票数据"],"summary":"Get Stock List","description":"获取股票列表: name=名称模糊 / code=代码精确(归一后), 二选一;\n都不给=全市场分页。互斥与语义护栏统一在本层校验","operationId":"get_stock_list_api_a_stock_list_get","parameters":[{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票名称(模糊匹配); 与code二选一","title":"Name"},"description":"股票名称(模糊匹配); 与code二选一"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码, 四种写法都认(sz000001/000001/sz.000001/000001.SZ)","title":"Code"},"description":"股票代码, 四种写法都认(sz000001/000001/sz.000001/000001.SZ)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"页码","default":1,"title":"Page"},"description":"页码"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"每页数量","default":20,"title":"Page Size"},"description":"每页数量"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/minute":{"get":{"tags":["股票数据"],"summary":"Get Minute Data","description":"获取股票分时数据","operationId":"get_minute_data_api_a_stock_minute_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"description":"股票代码"},{"name":"date","in":"query","required":true,"schema":{"type":"string","description":"日期，格式：YYYY-MM-DD","title":"Date"},"description":"日期，格式：YYYY-MM-DD"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/tick":{"get":{"tags":["股票数据"],"summary":"Get Tick Data","description":"获取股票分笔数据","operationId":"get_tick_data_api_a_stock_tick_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"description":"股票代码"},{"name":"date","in":"query","required":true,"schema":{"type":"string","description":"日期，格式：YYYY-MM-DD","title":"Date"},"description":"日期，格式：YYYY-MM-DD"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/minute_kline":{"get":{"tags":["股票数据"],"summary":"Get Minute Kline","description":"多周期分钟K线(5/15/30分钟 基础版; 60分钟K与近1年前历史 专业版 — 细粒度门槛按参数区分)\n\nperiod=1(2026-09-09): 历史库与盘中实时行拼接(is_realtime标记),\n实盘trader当日1分钟K专用; merge_days=N 合并最近N个交易日。\nstart_date(2026-10-08): 区间查询, 逐日拼接 —— 量化研究批量回补分钟K不再逐日调用。","operationId":"get_minute_kline_api_a_stock_minute_kline_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"description":"股票代码"},{"name":"period","in":"query","required":false,"schema":{"type":"integer","description":"周期(分钟): 1/5/15/30/60","default":5,"title":"Period"},"description":"周期(分钟): 1/5/15/30/60"},{"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":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"起始日期 YYYY-MM-DD(与end_date构成区间; 5/15/30/60分钟上限250个交易日, 1分钟上限10日)","title":"Start Date"},"description":"起始日期 YYYY-MM-DD(与end_date构成区间; 5/15/30/60分钟上限250个交易日, 1分钟上限10日)"},{"name":"merge_days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10,"minimum":1},{"type":"null"}],"description":"合并最近N个交易日(period=1专用; 缺省单日)","title":"Merge Days"},"description":"合并最近N个交易日(period=1专用; 缺省单日)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/financial":{"get":{"tags":["股票数据"],"summary":"Get Financial Data","description":"财务数据(EPS/ROE/每股净资产/资产负债表...约400字段)","operationId":"get_financial_data_api_a_stock_financial_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"description":"股票代码"},{"name":"report_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 YYYY-MM-DD(空=最新一期)","title":"Report Date"},"description":"报告期 YYYY-MM-DD(空=最新一期)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/st_list":{"get":{"tags":["股票数据"],"summary":"Get St List","description":"ST股名单(每日快照还原历史戴帽状态; 快照自2026-09-01起)","operationId":"get_st_list_api_a_stock_st_list_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新; 历史日期自动取≤该日最近一次快照)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新; 历史日期自动取≤该日最近一次快照)"},{"name":"sec_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"证券类型过滤: stock(默认)/all","default":"stock","title":"Sec Type"},"description":"证券类型过滤: stock(默认)/all"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/name_history":{"get":{"tags":["股票数据"],"summary":"Get Name History","description":"个股名称/ST戴帽/停牌状态时间线(每日快照)","operationId":"get_name_history_api_a_stock_name_history_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"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"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/blocks":{"get":{"tags":["股票数据"],"summary":"Get Blocks","description":"股票↔板块双向查询: code=查所属板块 / board=反查板块成分股","operationId":"get_blocks_api_a_stock_blocks_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(查所属板块); 与board二选一","title":"Code"},"description":"股票代码(查所属板块); 与board二选一"},{"name":"board","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"板块名(反查成分股); 与code二选一","title":"Board"},"description":"板块名(反查成分股); 与code二选一"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/special_list":{"get":{"tags":["股票数据"],"summary":"Get Special List","description":"特殊名单三模式(与 themes 的 theme/code 同构):\n无参=名单目录(list_name/member_count) / list_name=名单全量成员(码+名, 未知名单404)\n/ code=个股所属名单反查","operationId":"get_special_list_api_a_stock_special_list_get","parameters":[{"name":"list_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"名单名(如 沪股通/深股通/港股通/融资融券/中证500); 与code二选一","title":"List Name"},"description":"名单名(如 沪股通/深股通/港股通/融资融券/中证500); 与code二选一"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码: 反查个股所属名单(单列list_name); 与list_name二选一","title":"Code"},"description":"股票代码: 反查个股所属名单(单列list_name); 与list_name二选一"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/hsgt":{"get":{"tags":["股票数据"],"summary":"Get Hsgt","description":"沪深港通标的名单(北向沪股通+深股通, 南向港股通)","operationId":"get_hsgt_api_a_stock_hsgt_get","parameters":[{"name":"market","in":"query","required":false,"schema":{"type":"string","description":"sh沪股通/sz深股通/hk港股通/all默认三市","default":"all","title":"Market"},"description":"sh沪股通/sz深股通/hk港股通/all默认三市"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/f10":{"get":{"tags":["股票数据"],"summary":"Get F10","description":"F10公司资料(结构化): 公司概况/股本结构/股东研究(十大流通股东)/分红扩股/财务分析/龙虎榜单/高层治理...\n\n不传 category 返回栏目清单; 公司概况与股本结构为专项扁平结构,\n其余栏目为分节块结构(series=指标×日期 / matrix / kv / grid / text)。","operationId":"get_f10_api_a_stock_f10_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码(仅股票有公司资料)","title":"Code"},"description":"股票代码(仅股票有公司资料)"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"栏目名(缺省=返回可用栏目清单), 如 股东研究/分红扩股/财务分析","title":"Category"},"description":"栏目名(缺省=返回可用栏目清单), 如 股东研究/分红扩股/财务分析"},{"name":"section","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"小节过滤(仅通用栏目), 如 十大流通股东 所属的小节名","title":"Section"},"description":"小节过滤(仅通用栏目), 如 十大流通股东 所属的小节名"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/lhb":{"get":{"tags":["股票数据"],"summary":"Get Lhb","description":"龙虎榜每日明细(2023-01起): 上榜原因/类型/买卖总额/龙虎榜净买额\n\n不传日期=最新一天全榜; 传 code 看个股全部上榜日。","operationId":"get_lhb_api_a_stock_lhb_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"上榜日期 YYYY-MM-DD(与区间参数二选一, 缺省=最新一天)","title":"Date"},"description":"上榜日期 YYYY-MM-DD(与区间参数二选一, 缺省=最新一天)"},{"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":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选, 过滤个股)","title":"Code"},"description":"股票代码(可选, 过滤个股)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/lhb_detail":{"get":{"tags":["股票数据"],"summary":"Get Lhb Detail","description":"个股龙虎榜席位明细(2023-06起): 买/卖前5营业部 + 买卖金额 + 净额","operationId":"get_lhb_detail_api_a_stock_lhb_detail_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"description":"股票代码"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"上榜日期 YYYY-MM-DD(缺省=该股最近一次上榜)","title":"Date"},"description":"上榜日期 YYYY-MM-DD(缺省=该股最近一次上榜)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/lhb_history":{"get":{"tags":["股票数据"],"summary":"Get Lhb History","description":"个股历次上榜记录(2021-04起): 上榜类型/涨跌幅/买卖额/换手率","operationId":"get_lhb_history_api_a_stock_lhb_history_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"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":"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/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/margin":{"get":{"tags":["股票数据"],"summary":"Get Margin","description":"融资融券: scope=market 全市场融资融券余额序列(2026-04起)\nscope=stock 个股两融全历史(2010起, rzye融资余额/drjme融资净买入/rqyl融券余量)\nscope=stock+date 无code 全市场单日截面(2026-10-09, 按rzye降序; 调度每日一次调用)","operationId":"get_margin_api_a_stock_margin_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","description":"market=全市场余额序列 / stock=个股历史(需code)或全市场单日截面(需date)","default":"market","title":"Scope"},"description":"market=全市场余额序列 / stock=个股历史(需code)或全市场单日截面(需date)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(scope=stock且给date时不传=截面模式)","title":"Code"},"description":"股票代码(scope=stock且给date时不传=截面模式)"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"scope=stock且无code时: 全市场单日截面(T+1披露, date=披露日即交易日前一交易日)","title":"Date"},"description":"scope=stock且无code时: 全市场单日截面(T+1披露, date=披露日即交易日前一交易日)"},{"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":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限(截面模式全市场约4000行)","default":500,"title":"Limit"},"description":"返回条数上限(截面模式全市场约4000行)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/zdt":{"get":{"tags":["股票数据"],"summary":"Get Zdt","description":"涨跌停打板数据(2025-01起): 连板天梯(连板数/涨停时间/涨停原因)\n/ 跌停名单 / 涨停揭秘统计(涨停家数/炸板率等)","operationId":"get_zdt_api_a_stock_zdt_get","parameters":[{"name":"view","in":"query","required":false,"schema":{"type":"string","description":"ladder=连板天梯·个股 / dt=跌停个股 / stat=涨停揭秘统计","default":"ladder","title":"View"},"description":"ladder=连板天梯·个股 / dt=跌停个股 / stat=涨停揭秘统计"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日期 YYYY-MM-DD(缺省=最新一天)","title":"Date"},"description":"交易日期 YYYY-MM-DD(缺省=最新一天)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":1000,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/zdt_board_stat":{"get":{"tags":["股票数据"],"summary":"Get Zdt Board Stat","description":"连板天梯·板块统计(最新日快照): 各板块涨停家数/连板数/板块高度","operationId":"get_zdt_board_stat_api_a_stock_zdt_board_stat_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日期 YYYY-MM-DD(缺省=最新一天)","title":"Date"},"description":"交易日期 YYYY-MM-DD(缺省=最新一天)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/quote_snapshot":{"get":{"tags":["股票数据"],"summary":"Get Quote Snapshot","description":"盘后五档快照(2026-09-07起): 收盘价/量额/内外盘/买卖五档(每日收盘后归档)","operationId":"get_quote_snapshot_api_a_stock_quote_snapshot_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"description":"股票代码"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"交易日期 YYYY-MM-DD(缺省=该股最新一天)","title":"Date"},"description":"交易日期 YYYY-MM-DD(缺省=该股最新一天)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/tick_stats":{"get":{"tags":["股票数据"],"summary":"Get Tick Stats","description":"个股分笔日统计(2026-08-24起): tick明细的日级汇总 — 成交笔数/主动买卖(内外盘)量额/大单量额","operationId":"get_tick_stats_api_a_stock_tick_stats_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","description":"股票代码","title":"Code"},"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":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"返回条数上限","default":60,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/ah_premium":{"get":{"tags":["股票数据"],"summary":"Get Ah Premium","description":"AH溢价表(每日全量): A/H收盘价+港元汇率+溢价率(%)","operationId":"get_ah_premium_api_a_stock_ah_premium_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A股代码(sh600016)或H股代码(hk01988)过滤","title":"Code"},"description":"A股代码(sh600016)或H股代码(hk01988)过滤"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/movers":{"get":{"tags":["股票数据"],"summary":"Get Movers","description":"每日复盘·涨跌榜(2015-01起): 个股/行业涨跌幅榜 + 行业涨跌家数(赚钱效应)","operationId":"get_movers_api_a_stock_movers_get","parameters":[{"name":"tab","in":"query","required":false,"schema":{"type":"string","description":"gg=个股涨跌TOP10(涨幅榜RS0+跌幅榜RS1) / hy=行业涨跌榜","default":"gg","title":"Tab"},"description":"gg=个股涨跌TOP10(涨幅榜RS0+跌幅榜RS1) / hy=行业涨跌榜"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"复盘日期 YYYY-MM-DD(缺省=最新一天)","title":"Date"},"description":"复盘日期 YYYY-MM-DD(缺省=最新一天)"},{"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":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":100,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/block_trades":{"get":{"tags":["股票数据"],"summary":"Get Block Trades","description":"大宗交易统一视图(2010-01起): 全市场成交 + 云榜独有列整合(申报价量/\n后续7·30·90日收益/买卖席位明细) — 列 price/amt/vol/premium/close/byyb/syyb,\n云榜补充列可空(sbjg/sbsl/mmfx/sb7/sb30/sb90/seat_b/seat_s/ztype)","operationId":"get_block_trades_api_a_stock_block_trades_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"成交日期 YYYY-MM-DD(与区间/代码三选一, 缺省=最新一天)","title":"Date"},"description":"成交日期 YYYY-MM-DD(与区间/代码三选一, 缺省=最新一天)"},{"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":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(个股全部大宗历史)","title":"Code"},"description":"股票代码(个股全部大宗历史)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/report_calendar":{"get":{"tags":["股票数据"],"summary":"Get Report Calendar","description":"财报披露时间表(当期报告期滚动前瞻): 预约披露日期+倒计时天数","operationId":"get_report_calendar_api_a_stock_report_calendar_get","parameters":[{"name":"report_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 YYYY-MM-DD(缺省=最新期)","title":"Report Date"},"description":"报告期 YYYY-MM-DD(缺省=最新期)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选过滤)","title":"Code"},"description":"股票代码(可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"description":"返回条数上限","default":2000,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/earnings_forecast":{"get":{"tags":["股票数据"],"summary":"Get Earnings Forecast","description":"A股业绩预告(当期报告期): 预告类型(业绩大幅上升等)+预告全文","operationId":"get_earnings_forecast_api_a_stock_earnings_forecast_get","parameters":[{"name":"report_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 YYYY-MM-DD(缺省=最新期)","title":"Report Date"},"description":"报告期 YYYY-MM-DD(缺省=最新期)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选过滤)","title":"Code"},"description":"股票代码(可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"description":"返回条数上限","default":2000,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/rating":{"get":{"tags":["股票数据"],"summary":"Get Rating","description":"券商研报评级流(2023起全量): 评级值(5买4增3中2减)/变化(调高/维持/首次)/券商/分析师/行业","operationId":"get_rating_api_a_stock_rating_get","parameters":[{"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":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数上限","default":200,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/ipo_audit":{"get":{"tags":["股票数据"],"summary":"Get Ipo Audit","description":"新股审核/发行全队列(每日快照): 过会登记/核准/申购起止/批文号/上市日","operationId":"get_ipo_audit_api_a_stock_ipo_audit_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选过滤)","title":"Code"},"description":"股票代码(可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":3000,"minimum":1,"description":"返回条数上限","default":1500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/lhb_yyb":{"get":{"tags":["股票数据"],"summary":"Get Lhb Yyb","description":"龙虎榜营业部明细(日快照): 地区/买卖营业部/买卖合计/方向/席别","operationId":"get_lhb_yyb_api_a_stock_lhb_yyb_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新一天)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新一天)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选过滤)","title":"Code"},"description":"股票代码(可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/lhb_active":{"get":{"tags":["股票数据"],"summary":"Get Lhb Active","description":"活跃龙虎榜席位(日快照): 上榜次数/连买连卖/占比/涨幅","operationId":"get_lhb_active_api_a_stock_lhb_active_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新一天)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新一天)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选过滤)","title":"Code"},"description":"股票代码(可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/zdt_board_height":{"get":{"tags":["股票数据"],"summary":"Get Zdt Board Height","description":"板块连板高度序列(日快照): 各板块连板高度/汇总高度, 支持单日/区间","operationId":"get_zdt_board_height_api_a_stock_zdt_board_height_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新一天)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新一天)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"起始日期 YYYY-MM-DD(区间模式, 与date互斥)","title":"Start Date"},"description":"起始日期 YYYY-MM-DD(区间模式, 与date互斥)"},{"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":"bk_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"板块指数代码(880/881, 可选过滤)","title":"Bk Code"},"description":"板块指数代码(880/881, 可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/inst_holdings_chg":{"get":{"tags":["股票数据"],"summary":"Get Inst Holdings Chg","description":"机构增减持动静(日快照): 机构持有数(万)/买入/卖出","operationId":"get_inst_holdings_chg_api_a_stock_inst_holdings_chg_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新一天)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新一天)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选过滤)","title":"Code"},"description":"股票代码(可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/inst_holdings_rank":{"get":{"tags":["股票数据"],"summary":"Get Inst Holdings Rank","description":"私募机构持股榜(日快照): 机构名/报告期/持股市值(万)/占流通比%/行业","operationId":"get_inst_holdings_rank_api_a_stock_inst_holdings_rank_get","parameters":[{"name":"report_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"报告期 YYYY-MM-DD(缺省=最新一期)","title":"Report Date"},"description":"报告期 YYYY-MM-DD(缺省=最新一期)"},{"name":"inst_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"机构名称模糊匹配(可选)","title":"Inst Name"},"description":"机构名称模糊匹配(可选)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选过滤)","title":"Code"},"description":"股票代码(可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/holders_chg":{"get":{"tags":["股票数据"],"summary":"Get Holders Chg","description":"股东增减持动静(日快照, 全股东口径): 增持/减持/净增持市值(万) + 区间价格","operationId":"get_holders_chg_api_a_stock_holders_chg_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新一天)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新一天)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(可选过滤)","title":"Code"},"description":"股票代码(可选过滤)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/themes":{"get":{"tags":["股票数据"],"summary":"Get Themes","description":"主题题材映射: theme 缺省=题材清单 / theme=成分股清单 / code=个股所属题材","operationId":"get_themes_api_a_stock_themes_get","parameters":[{"name":"theme","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"题材名(缺省=题材清单+成员数)","title":"Theme"},"description":"题材名(缺省=题材清单+成员数)"},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代码(反查个股所属题材)","title":"Code"},"description":"股票代码(反查个股所属题材)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/stock/bk_leaders":{"get":{"tags":["股票数据"],"summary":"Get Bk Leaders","description":"板块龙头榜(bkld101): 各窗口(1周/1月/3月/1年)涨跌幅龙头榜 —\ncolheader 自描述, 列含义见返回 headers","operationId":"get_bk_leaders_api_a_stock_bk_leaders_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快照日期 YYYY-MM-DD(缺省=最新快照)","title":"Date"},"description":"快照日期 YYYY-MM-DD(缺省=最新快照)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"description":"返回条数上限","default":500,"title":"Limit"},"description":"返回条数上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/market/trade_calendar":{"get":{"tags":["交易日历"],"summary":"Get Trade Calendar","description":"交易日历: 区间内A股交易日列表(升序)","operationId":"get_trade_calendar_api_a_market_trade_calendar_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"起始日期 YYYY-MM-DD, 缺省当年1月1日","title":"Start Date"},"description":"起始日期 YYYY-MM-DD, 缺省当年1月1日"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 YYYY-MM-DD, 缺省今天","title":"End Date"},"description":"结束日期 YYYY-MM-DD, 缺省今天"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/a/market/index_breadth":{"get":{"tags":["交易日历"],"summary":"Get Index Breadth","description":"每日复盘·指数涨跌家数(2015-01起): 9指数涨跌幅+上涨/下跌家数(赚钱效应核心列);\n与 /breadth 同属市场宽度口径(2026-10-11 起 stock 域旧路径已撤, 唯一入口在 market 域)","operationId":"get_index_breadth_api_a_market_index_breadth_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指数代码过滤: 999999/000010/399001 等, 带前缀(sh999999)亦可","title":"Code"},"description":"指数代码过滤: 999999/000010/399001 等, 带前缀(sh999999)亦可"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"起始日期 YYYY-MM-DD","title":"Start Date"},"description":"起始日期 YYYY-MM-DD"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"结束日期 YYYY-MM-DD","title":"End Date"},"description":"结束日期 YYYY-MM-DD"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"description":"返回条数上限(9指数×日, 全史~2.6万行, 建议配区间)","default":60,"title":"Limit"},"description":"返回条数上限(9指数×日, 全史~2.6万行, 建议配区间)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/info":{"get":{"tags":["用户管理"],"summary":"User Info","description":"获取当前用户信息（需要 API Key）","operationId":"user_info_api_user_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/user/usage":{"get":{"tags":["用户管理"],"summary":"Usage","description":"获取用量统计(按用户维度; 无Key新用户返回零值而非401, 2026-10-14)","operationId":"usage_api_user_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/user/usage/trend":{"get":{"tags":["用户管理"],"summary":"Usage Trend","description":"获取调用量趋势（最近 N 天）","operationId":"usage_trend_api_user_usage_trend_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":7,"description":"查询天数","default":30,"title":"Days"},"description":"查询天数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/keys":{"get":{"tags":["用户管理"],"summary":"My Keys","description":"列出当前用户的所有 API Key","operationId":"my_keys_api_user_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}},"post":{"tags":["用户管理"],"summary":"Create Key","description":"创建新的 API Key(启用数达上限时 409)","operationId":"create_key_api_user_keys_post","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string","description":"Key 名称","default":"自定义Key","title":"Name"},"description":"Key 名称"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/orders":{"post":{"tags":["用户管理"],"summary":"Place Order","description":"创建购买订单(会员订阅/加油包/首购体验) → 收银台跳转链接","operationId":"place_order_api_user_orders_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["用户管理"],"summary":"My Orders","description":"我的订单列表(最近优先) —— 用户侧唯一账单卡(2026-10-04 与 admin-ui 订单管理同构)\n\n人工开通单(meta=plan_request:*)一并返回, 并携带关联申请摘要(req_id/req_status/\nreq_plan/req_cycle/has_proof), 前端据此在同一张表里给出 上传凭证/重新申请 操作;\n不再单独维护「开通申请」卡。","operationId":"my_orders_api_user_orders_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/orders/{order_no}":{"get":{"tags":["用户管理"],"summary":"Order Status","description":"订单状态轮询(支付回跳后确认开通结果)","operationId":"order_status_api_user_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/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/subscription":{"get":{"tags":["用户管理"],"summary":"My Subscription","description":"会员状态总览(档位/到期/积分余额/加油包余量)","operationId":"my_subscription_api_user_subscription_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/user/products":{"get":{"tags":["用户管理"],"summary":"Products","description":"可购商品目录(会员订阅/加油包, 价格与定价页同源)","operationId":"products_api_user_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/user/points-log":{"get":{"tags":["用户管理"],"summary":"My Points Log","description":"积分流水(充值赠分/抵扣/贡献; Σdelta == 当前余额)","operationId":"my_points_log_api_user_points_log_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":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/pricing-plans":{"get":{"tags":["用户管理"],"summary":"Pricing Plans","description":"档位价格卡 —— SPA 定价页/账单页/申请弹窗共用(工作台接口, 随全局Key鉴权;\n匿名访客走 SSR /pricing 服务端直出同一数据)。\n\n价格/配额单一来源 core/tiers.py TIERS, 与 SSR /pricing、commerce 商品目录\n同一构建器(commerce.pricing_cards); 前端不维护价格数字。","operationId":"pricing_plans_api_user_pricing_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/user/platform-status":{"get":{"tags":["用户管理"],"summary":"Platform Status","description":"平台状态(个人中心「平台与支持」卡): 行情数据最新交易日。\n\ngupiao_data.a_trade_date 是预生成日历(含未来日期), 必须取 <= 今天的\nMAX(date) 才是\"数据应已更新至\"的交易日; 数据域异常时回落 None,\n前端显示占位, 不炸个人中心。","operationId":"platform_status_api_user_platform_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/user/entitlements":{"get":{"tags":["用户管理"],"summary":"My Entitlements","description":"我的订阅权限清单 —— 生效档位(effective_level 到期自动回落) + 接口分组权限。\n\n单一来源 core/tiers.py 的 API_TABLE(rank/中文名/简述三元组), 归堆展示;\n前端个人中心「我的订阅」卡消费, 不在端上维护权限表。","operationId":"my_entitlements_api_user_entitlements_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/user/plan-request":{"post":{"tags":["用户管理"],"summary":"Submit Plan Request","description":"提交付费套餐开通申请(管理员审批后开通)","operationId":"submit_plan_request_api_user_plan_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanRequestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/plan-requests":{"get":{"tags":["用户管理"],"summary":"My Plan Requests","description":"本人的开通申请列表(状态跟踪: 待处理/已批准/已拒绝 + 凭证摘要)\n\nPAY_OFFLINE_INFO 一并返回: 已有待处理申请时(重复提交409)弹窗也能拿到收款说明。","operationId":"my_plan_requests_api_user_plan_requests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/user/plan-request/{req_id}/pay-proof":{"post":{"tags":["用户管理"],"summary":"Upload Pay Proof","description":"为本人待处理申请上传付款凭证(可重复补交覆盖, 审批后锁定)","operationId":"upload_pay_proof_api_user_plan_request__req_id__pay_proof_post","parameters":[{"name":"req_id","in":"path","required":true,"schema":{"type":"integer","title":"Req Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayProofRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/password":{"post":{"tags":["用户管理"],"summary":"Change Password","description":"自助修改密码(已知旧密码; 忘密码走管理员重置)","operationId":"change_password_api_user_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordChange"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/keys/{key_id}":{"delete":{"tags":["用户管理"],"summary":"Disable Key","description":"禁用(停用)自己的Key — 可再启用(POST /keys/{id}/enable);\n防自锁: 至少保留一把启用中的Key","operationId":"disable_key_api_user_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":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/keys/{key_id}/enable":{"post":{"tags":["用户管理"],"summary":"Enable Key","description":"重新启用已禁用的Key(同受启用数上限约束)","operationId":"enable_key_api_user_keys__key_id__enable_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/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/user/usage/export":{"get":{"tags":["用户管理"],"summary":"Export Usage Csv","description":"月度用量明细CSV(按日×端点聚合, 用户全部Key合计) — 计费透明化","operationId":"export_usage_csv_api_user_usage_export_get","parameters":[{"name":"month","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$","description":"账单月份 YYYY-MM","title":"Month"},"description":"账单月份 YYYY-MM"}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/overview":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Overview","description":"数据看板: 今日调用/用户数/活跃Key/待审批 + 近7日调用趋势","operationId":"admin_overview_api_admin_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/admin/weekly":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Weekly","description":"运营周报: 北极星(周活跃调用用户)/激活率/月度收入ARPPU/M2留存/配额压力","operationId":"admin_weekly_api_admin_weekly_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/admin/data":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Data Tables","description":"可浏览的数据表清单(含行数)","operationId":"admin_data_tables_api_admin_data_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/admin/data/{table}":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Table Rows","description":"指定表的最新N行(白名单表; blob表附核对元信息)","operationId":"admin_table_rows_api_admin_data__table__get","parameters":[{"name":"table","in":"path","required":true,"schema":{"type":"string","title":"Table"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/pipeline":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Pipeline","description":"数据管道健康: 各表最新日期/滞后 + 采集账本心跳 + 健康检查(只读gupiao_data)","operationId":"admin_pipeline_api_admin_pipeline_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/admin/audit":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Audit","description":"管理员操作审计日志","operationId":"admin_audit_api_admin_audit_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":30,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Users","description":"用户列表","operationId":"admin_users_api_admin_users_get","parameters":[{"name":"keyword","in":"query","required":false,"schema":{"type":"string","description":"邮箱/ID搜索","title":"Keyword"},"description":"邮箱/ID搜索"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/detail":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin User Detail","description":"用户详情: 基本信息 + 全部Key + 订阅记录 + 近30天用量","operationId":"admin_user_detail_api_admin_users__user_id__detail_get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/plan":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Set Plan","description":"手动开通/续期套餐(快验证模式的开通入口)","operationId":"admin_set_plan_api_admin_users__user_id__plan_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}},{"name":"plan","in":"query","required":true,"schema":{"type":"string","description":"档位: free/base/pro/elite","title":"Plan"},"description":"档位: free/base/pro/elite"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":3650,"minimum":1,"description":"有效天数","default":30,"title":"Days"},"description":"有效天数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/set-admin":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Set Admin","description":"设置/取消管理员(拒绝自我降权, 防管理台锁死)","operationId":"admin_set_admin_api_admin_users__user_id__set_admin_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}},{"name":"is_admin","in":"query","required":true,"schema":{"type":"integer","maximum":1,"minimum":0,"description":"1=提权 0=降权","title":"Is Admin"},"description":"1=提权 0=降权"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/reset-password":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Reset Password","description":"重置用户密码 → 一次性返回临时密码(线下交付; 用户登录后自助改密)","operationId":"admin_reset_password_api_admin_users__user_id__reset_password_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/points":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Adjust Points","description":"手动调整用户积分(贡献奖励/补偿/纠错) — 走唯一入账口+流水+缓存失效","operationId":"admin_adjust_points_api_admin_users__user_id__points_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}},{"name":"delta","in":"query","required":true,"schema":{"type":"integer","description":"积分变动(正=加, 负=扣, 下限0)","title":"Delta"},"description":"积分变动(正=加, 负=扣, 下限0)"},{"name":"reason","in":"query","required":false,"schema":{"type":"string","description":"purchase/contribution/gift/admin_adjust","default":"admin_adjust","title":"Reason"},"description":"purchase/contribution/gift/admin_adjust"},{"name":"note","in":"query","required":false,"schema":{"type":"string","description":"备注(展示给管理台流水)","default":"","title":"Note"},"description":"备注(展示给管理台流水)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/points-log":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Points Log","description":"用户积分流水(对账口径: Σdelta == 当前points)","operationId":"admin_points_log_api_admin_users__user_id__points_log_get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}},{"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":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/users/{user_id}/quota":{"patch":{"tags":["管理后台(仅管理员)"],"summary":"Admin Set Quota","description":"直接调整单用户日配额(档位默认值之外的运营特批; 即时生效)","operationId":"admin_set_quota_api_admin_users__user_id__quota_patch","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}},{"name":"daily_quota","in":"query","required":true,"schema":{"type":"integer","maximum":10000000,"minimum":1,"description":"新日配额(次/天)","title":"Daily Quota"},"description":"新日配额(次/天)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/keys":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Keys","description":"全量Key列表(含所属邮箱)","operationId":"admin_keys_api_admin_keys_get","parameters":[{"name":"keyword","in":"query","required":false,"schema":{"type":"string","description":"Key/邮箱搜索","title":"Keyword"},"description":"Key/邮箱搜索"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/keys/{key_id}/toggle":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Toggle Key","description":"启用/停用 API Key(停用立即生效, 同步清认证缓存)","operationId":"admin_toggle_key_api_admin_keys__key_id__toggle_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/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/plan-requests":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Plan Requests","description":"套餐开通申请列表","operationId":"admin_plan_requests_api_admin_plan_requests_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"pending/done/rejected, 空=全部","default":"pending","title":"Status"},"description":"pending/done/rejected, 空=全部"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/plan-requests/{req_id}/pay-proof":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Pay Proof","description":"付款凭证原图(base64 dataURL, 管理端核验展示用)","operationId":"admin_pay_proof_api_admin_plan_requests__req_id__pay_proof_get","parameters":[{"name":"req_id","in":"path","required":true,"schema":{"type":"integer","title":"Req Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/plan-requests/{req_id}/approve":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Approve Request","description":"批准开通(按申请的套餐执行)","operationId":"admin_approve_request_api_admin_plan_requests__req_id__approve_post","parameters":[{"name":"req_id","in":"path","required":true,"schema":{"type":"integer","title":"Req Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/plan-requests/{req_id}/reject":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Reject Request","description":"拒绝开通申请","operationId":"admin_reject_request_api_admin_plan_requests__req_id__reject_post","parameters":[{"name":"req_id","in":"path","required":true,"schema":{"type":"integer","title":"Req Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/docs":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Docs List","description":"全量文档(含is_public=0的隐藏条目)","operationId":"admin_docs_list_api_admin_docs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/api/admin/docs/{doc_id}":{"put":{"tags":["管理后台(仅管理员)"],"summary":"Admin Docs Upsert","description":"创建/更新一条接口文档(按body.doc_id路由, 路径参数仅作审计标识)","operationId":"admin_docs_upsert_api_admin_docs__doc_id__put","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Doc"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["管理后台(仅管理员)"],"summary":"Admin Docs Delete","description":"删除一条接口文档(软删除: 打is_deleted标记, 公开页即隐藏)","operationId":"admin_docs_delete_api_admin_docs__doc_id__delete","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/docs/{doc_id}/restore":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Docs Restore","description":"恢复一条软删除的接口文档","operationId":"admin_docs_restore_api_admin_docs__doc_id__restore_post","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/orders":{"get":{"tags":["管理后台(仅管理员)"],"summary":"Admin Orders","description":"订单列表: 状态/关键字/时间窗筛选 + 实付小计(对账)","operationId":"admin_orders_api_admin_orders_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":16,"description":"created/paid/closed/refunded, 空=全部","default":"","title":"Status"},"description":"created/paid/closed/refunded, 空=全部"},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":64,"description":"单号/邮箱/用户ID","default":"","title":"Q"},"description":"单号/邮箱/用户ID"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":0,"description":"近N天, 0=不限","default":0,"title":"Days"},"description":"近N天, 0=不限"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/orders/{order_no}/fulfill":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Order Fulfill","description":"掉单补偿: 手动触发开通 —— 走 commerce.fulfill_order 幂等闸门, 重复调用无副作用","operationId":"admin_order_fulfill_api_admin_orders__order_no__fulfill_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/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/orders/{order_no}/verify":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Order Verify","description":"人工转账核验通过: 订单→paid + 按关联申请开通(复用 approve_request, 含存量兜底)","operationId":"admin_order_verify_api_admin_orders__order_no__verify_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/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/orders/{order_no}/reject":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Order Reject","description":"人工转账核验驳回: 订单→closed + 申请单→rejected","operationId":"admin_order_reject_api_admin_orders__order_no__reject_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/APIResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/orders/close-stale":{"post":{"tags":["管理后台(仅管理员)"],"summary":"Admin Orders Close Stale","description":"关闭超时未付订单(created 超过 ORDER_TTL_MIN, 默认120分钟)","operationId":"admin_orders_close_stale_api_admin_orders_close_stale_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIResponse"}}}}}}},"/health":{"get":{"summary":"Health Check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"APIResponse":{"properties":{"code":{"type":"integer","title":"Code","default":200},"message":{"type":"string","title":"Message","default":"success"},"data":{"anyOf":[{},{"type":"null"}],"title":"Data"}},"type":"object","title":"APIResponse","description":"统一响应信封"},"CreateOrderRequest":{"properties":{"sku":{"type":"string","title":"Sku","description":"商品码: member_pro_y / boost_m / trial_pro_7d ..."},"use_points":{"type":"boolean","title":"Use Points","description":"是否使用积分抵扣(100分=1元)","default":false}},"type":"object","required":["sku"],"title":"CreateOrderRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoginRequest":{"properties":{"email":{"type":"string","title":"Email","description":"邮箱地址"},"password":{"type":"string","title":"Password","description":"密码"},"captcha_id":{"type":"string","maxLength":64,"minLength":8,"title":"Captcha Id","description":"GET /auth/captcha 返回的验证码ID"},"captcha_code":{"type":"string","maxLength":8,"minLength":3,"title":"Captcha Code","description":"图片验证码字符(不区分大小写)"}},"type":"object","required":["email","password","captcha_id","captcha_code"],"title":"LoginRequest"},"MiniConfirmRequest":{"properties":{"scene":{"type":"string","maxLength":32,"minLength":8,"title":"Scene","description":"小程序码携带的一次性 scene"},"code":{"type":"string","maxLength":128,"minLength":8,"title":"Code","description":"小程序 wx.login 返回的临时登录凭证"},"nickname":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Nickname","description":"可选, 小程序端带回的昵称"},"avatar":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Avatar","description":"可选, 小程序端带回的头像"},"email":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Email","description":"绑定/注册邮箱(need_bind 表单回传)"},"password":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Password","description":"账号密码(min_length 在业务层校验, 给错误文案留余地而非422)"},"invite_code":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Invite Code","description":"邀请码(空则用出码时烙进 scene 的)"}},"type":"object","required":["scene","code"],"title":"MiniConfirmRequest"},"PasswordChange":{"properties":{"old_password":{"type":"string","title":"Old Password","description":"旧密码"},"new_password":{"type":"string","title":"New Password","description":"新密码(至少6位)"}},"type":"object","required":["old_password","new_password"],"title":"PasswordChange"},"PayProofRequest":{"properties":{"channel":{"type":"string","title":"Channel","description":"付款渠道: wechat/alipay"},"amount":{"type":"number","exclusiveMinimum":0.0,"title":"Amount","description":"实付金额(元)"},"proof":{"type":"string","title":"Proof","description":"付款截图 dataURL(png/jpeg/webp, ≤2MB)"}},"type":"object","required":["channel","amount","proof"],"title":"PayProofRequest","description":"付款凭证: 定价页申请开通后上传截图(管理员审批时人工核验)"},"PlanRequestRequest":{"properties":{"plan":{"type":"string","title":"Plan","description":"申请套餐: base/pro/elite"},"cycle":{"type":"string","title":"Cycle","description":"订阅周期: m=月付(30天) y=年付(365天) t=首购体验(专业版7天¥9)","default":"m"}},"type":"object","required":["plan"],"title":"PlanRequestRequest"},"QrcodeRequest":{"properties":{"invite_code":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Invite Code","description":"邀请码(可选): 未绑定用户注册时预填, 双边各得邀请奖励"}},"type":"object","title":"QrcodeRequest","description":"出码请求体(可省): 邀请链接落地页把邀请码烙进 scene, 供小程序端预填"},"RefreshRequest":{"properties":{"refresh_token":{"type":"string","maxLength":2048,"minLength":16,"title":"Refresh Token","description":"登录/注册时下发的 refresh_token"}},"type":"object","required":["refresh_token"],"title":"RefreshRequest"},"RegisterRequest":{"properties":{"email":{"type":"string","title":"Email","description":"邮箱地址"},"password":{"type":"string","minLength":6,"title":"Password","description":"密码（最少6位）"},"captcha_id":{"type":"string","maxLength":64,"minLength":8,"title":"Captcha Id","description":"GET /auth/captcha 返回的验证码ID"},"captcha_code":{"type":"string","maxLength":8,"minLength":3,"title":"Captcha Code","description":"图片验证码字符(不区分大小写)"},"invite_code":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Invite Code","description":"邀请码(可选): 填有效码则双边各得邀请奖励积分"}},"type":"object","required":["email","password","captcha_id","captcha_code"],"title":"RegisterRequest"},"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"},"WechatBindRequest":{"properties":{"bind_ticket":{"type":"string","maxLength":1024,"minLength":32,"title":"Bind Ticket","description":"扫码未绑定时下发的短时效绑定票据(5分钟)"},"email":{"type":"string","maxLength":128,"title":"Email","description":"绑定/注册邮箱"},"password":{"type":"string","maxLength":128,"title":"Password","description":"账号密码(min_length 在业务层校验, 给错误文案留余地)"},"invite_code":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Invite Code","description":"邀请码(选填)"}},"type":"object","required":["bind_ticket","email","password"],"title":"WechatBindRequest","description":"未绑定微信的绑定/注册请求(凭 /wechat/login 下发的绑定票据)"},"WechatLoginRequest":{"properties":{"code":{"type":"string","maxLength":128,"minLength":8,"title":"Code","description":"扫码回调地址上携带的授权码 code"}},"type":"object","required":["code"],"title":"WechatLoginRequest"}},"securitySchemes":{"XApiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"security":[{"XApiKey":[]}]}