首頁 探索 說明
註冊 登入
SD-SafeAI
/
shudao-main
3
0
複刻 0
Files 問題管理 0 合併請求 0 Wiki
分支: dev
分支列表 標籤列表
shudao-main
/
api-docs.html

api-docs.html 45 KB
永久連結 文件歷史 原始文件

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739 
  1. <!DOCTYPE html>
    2. 

  2. <html lang="zh-CN">
    3. 

  3. <head>
    4. 

  4.     <meta charset="UTF-8">
    5. 

  5.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
    6. 

  6.     <title>蜀道安全AI系统 - API接口文档</title>
    7. 

  7.     <style>
    8. 

  8.         * { margin: 0; padding: 0; box-sizing: border-box; }
    9. 

  9.         body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #fafafa; color: #3b4151; }
    10. 

  10.         .header { background: linear-gradient(135deg, #1f8a70 0%, #2d5a4a 100%); color: white; padding: 20px 30px; }
    11. 

  11.         .header h1 { font-size: 28px; margin-bottom: 5px; }
    12. 

  12.         .header p { opacity: 0.9; font-size: 14px; }
    13. 

  13.         .container { max-width: 1800px; margin: 0 auto; padding: 20px; }
    14. 

  14.         .api-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 15px; }
    15. 

  15.         .api-card { background: white; border-radius: 8px; box-shadow: 0 1px 3px rgba(0,0,0,0.12); overflow: hidden; }
    16. 

  16.         .api-card-header { padding: 12px 15px; display: flex; align-items: center; gap: 10px; border-bottom: 1px solid #eee; }
    17. 

  17.         .method { padding: 4px 10px; border-radius: 4px; font-size: 11px; font-weight: 700; color: white; text-transform: uppercase; }
    18. 

  18.         .method.get { background: #61affe; }
    19. 

  19.         .method.post { background: #49cc90; }
    20. 

  20.         .api-path { font-family: monospace; font-size: 13px; color: #3b4151; word-break: break-all; }
    21. 

  21.         .api-card-body { padding: 12px 15px; }
    22. 

  22.         .api-title { font-size: 14px; font-weight: 600; color: #3b4151; margin-bottom: 8px; }
    23. 

  23.         .api-desc { font-size: 12px; color: #6b7280; line-height: 1.5; margin-bottom: 10px; }
    24. 

  24.         .params-title { font-size: 11px; font-weight: 600; color: #1f8a70; margin-bottom: 5px; text-transform: uppercase; }
    25. 

  25.         .param-item { font-size: 11px; color: #4b5563; padding: 3px 0; border-bottom: 1px dashed #e5e7eb; }
    26. 

  26.         .param-item:last-child { border-bottom: none; }
    27. 

  27.         .param-name { font-family: monospace; color: #1f8a70; font-weight: 500; }
    28. 

  28.         .param-type { color: #9ca3af; font-size: 10px; }
    29. 

  29.         .section-title { font-size: 18px; font-weight: 600; color: #1f8a70; margin: 25px 0 15px; padding-bottom: 8px; border-bottom: 2px solid #1f8a70; }
    30. 

  30.         .tag { display: inline-block; padding: 2px 6px; background: #e0f2f1; color: #1f8a70; border-radius: 3px; font-size: 10px; margin-right: 5px; }
    31. 

  31.         .response-tag { background: #fef3c7; color: #92400e; }
    32. 

  32.         @media (max-width: 1200px) { .api-grid { grid-template-columns: repeat(2, 1fr); } }
    33. 

  33.         @media (max-width: 768px) { .api-grid { grid-template-columns: 1fr; } }
    34. 

  34.     </style>
    35. 

  35. </head>
    36. 

  36. <body>
    37. 

  37.     <div class="header">
    38. 

  38.         <h1>🛡️ 蜀道安全AI系统 API文档</h1>
    39. 

  39.         <p>ShuDao SafeAI Backend API v1.0 | 基础路径: /apiv1</p>
    40. 

  40.     </div>
    41. 

  41.     <div class="container">
    42. 

  42. 

  43.         <!-- 认证接口 -->
    44. 

  44.         <h2 class="section-title">🔐 认证接口</h2>
    45. 

  45.         <div class="api-grid">
    46. 

  46.             <div class="api-card">
    47. 

  47.                 <div class="api-card-header">
    48. 

  48.                     <span class="method post">POST</span>
    49. 

  49.                     <span class="api-path">/apiv1/auth/local_login</span>
    50. 

  50.                 </div>
    51. 

  51.                 <div class="api-card-body">
    52. 

  52.                     <div class="api-title">本地登录</div>
    53. 

  53.                     <div class="api-desc">用户名密码登录，返回JWT Token（需配置enable_local_login=true）</div>
    54. 

  54.                     <div class="params-title">请求参数 (Body JSON)</div>
    55. 

  55.                     <div class="param-item"><span class="param-name">username</span> <span class="param-type">string</span> - 用户名</div>
    56. 

  56.                     <div class="param-item"><span class="param-name">password</span> <span class="param-type">string</span> - 密码</div>
    57. 

  57.                     <div class="params-title" style="margin-top:8px">响应</div>
    58. 

  58.                     <div class="param-item"><span class="tag response-tag">200</span> token, userInfo</div>
    59. 

  59.                 </div>
    60. 

  60.             </div>
    61. 

  61.         </div>
    62. 

  62. 

  63.         <!-- AI对话接口 -->
    64. 

  64.         <h2 class="section-title">💬 AI对话接口</h2>
    65. 

  65.         <div class="api-grid">
    66. 

  66.             <div class="api-card">
    67. 

  67.                 <div class="api-card-header">
    68. 

  68.                     <span class="method post">POST</span>
    69. 

  69.                     <span class="api-path">/apiv1/send_deepseek_message</span>
    70. 

  70.                 </div>
    71. 

  71.                 <div class="api-card-body">
    72. 

  72.                     <div class="api-title">发送DeepSeek消息</div>
    73. 

  73.                     <div class="api-desc">发送消息到AI模型，支持安全培训PPT生成、AI写作等业务类型</div>
    74. 

  74.                     <div class="params-title">请求参数 (Body JSON)</div>
    75. 

  75.                     <div class="param-item"><span class="param-name">message</span> <span class="param-type">string</span> - 用户消息</div>
    76. 

  76.                     <div class="param-item"><span class="param-name">ai_conversation_id</span> <span class="param-type">uint64</span> - 对话ID(可选)</div>
    77. 

  77.                     <div class="param-item"><span class="param-name">business_type</span> <span class="param-type">int</span> - 业务类型(1:安全培训,2:AI写作)</div>
    78. 

  78.                     <div class="param-item"><span class="param-name">exam_name</span> <span class="param-type">string</span> - 考试名称(可选)</div>
    79. 

  79.                 </div>
    80. 

  80.             </div>
    81. 

  81.             <div class="api-card">
    82. 

  82.                 <div class="api-card-header">
    83. 

  83.                     <span class="method post">POST</span>
    84. 

  84.                     <span class="api-path">/apiv1/stream/chat</span>
    85. 

  85.                 </div>
    86. 

  86.                 <div class="api-card-body">
    87. 

  87.                     <div class="api-title">流式聊天 (SSE)</div>
    88. 

  88.                     <div class="api-desc">流式输出AI回复，支持RAG检索增强生成</div>
    89. 

  89.                     <div class="params-title">请求参数 (Body JSON)</div>
    90. 

  90.                     <div class="param-item"><span class="param-name">message</span> <span class="param-type">string</span> - 用户消息</div>
    91. 

  91.                     <div class="param-item"><span class="param-name">model</span> <span class="param-type">string</span> - 模型名称(可选)</div>
    92. 

  92.                     <div class="params-title" style="margin-top:8px">响应</div>
    93. 

  93.                     <div class="param-item"><span class="tag">SSE</span> text/event-stream</div>
    94. 

  94.                 </div>
    95. 

  95.             </div>
    96. 

  96.             <div class="api-card">
    97. 

  97.                 <div class="api-card-header">
    98. 

  98.                     <span class="method post">POST</span>
    99. 

  99.                     <span class="api-path">/apiv1/stream/chat-with-db</span>
    100. 

  100.                 </div>
    101. 

  101.                 <div class="api-card-body">
    102. 

  102.                     <div class="api-title">流式聊天(数据库集成)</div>
    103. 

  103.                     <div class="api-desc">流式聊天并自动保存对话记录到数据库</div>
    104. 

  104.                     <div class="params-title">请求参数 (Body JSON)</div>
    105. 

  105.                     <div class="param-item"><span class="param-name">message</span> <span class="param-type">string</span> - 用户消息</div>
    106. 

  106.                     <div class="param-item"><span class="param-name">ai_conversation_id</span> <span class="param-type">uint64</span> - 对话ID</div>
    107. 

  107.                     <div class="param-item"><span class="param-name">business_type</span> <span class="param-type">int</span> - 业务类型</div>
    108. 

  108.                     <div class="param-item"><span class="param-name">online_search_content</span> <span class="param-type">string</span> - 联网搜索内容</div>
    109. 

  109.                 </div>
    110. 

  110.             </div>
    111. 

  111.             <div class="api-card">
    112. 

  112.                 <div class="api-card-header">
    113. 

  113.                     <span class="method get">GET</span>
    114. 

  114.                     <span class="api-path">/apiv1/get_history_record</span>
    115. 

  115.                 </div>
    116. 

  116.                 <div class="api-card-body">
    117. 

  117.                     <div class="api-title">获取历史记录</div>
    118. 

  118.                     <div class="api-desc">获取当前用户的AI对话历史记录列表</div>
    119. 

  119.                     <div class="params-title">请求参数</div>
    120. 

  120.                     <div class="param-item">无参数，从Token获取用户ID</div>
    121. 

  121.                 </div>
    122. 

  122.             </div>
    123. 

  123.             <div class="api-card">
    124. 

  124.                 <div class="api-card-header">
    125. 

  125.                     <span class="method post">POST</span>
    126. 

  126.                     <span class="api-path">/apiv1/delete_conversation</span>
    127. 

  127.                 </div>
    128. 

  128.                 <div class="api-card-body">
    129. 

  129.                     <div class="api-title">删除对话</div>
    130. 

  130.                     <div class="api-desc">删除指定的AI对话</div>
    131. 

  131.                     <div class="params-title">请求参数 (Body JSON)</div>
    132. 

  132.                     <div class="param-item"><span class="param-name">ai_conversation_id</span> <span class="param-type">uint64</span> - 对话ID</div>
    133. 

  133.                 </div>
    134. 

  134.             </div>
    135. 

  135.             <div class="api-card">
    136. 

  136.                 <div class="api-card-header">
    137. 

  137.                     <span class="method post">POST</span>
    138. 

  138.                     <span class="api-path">/apiv1/delete_history_record</span>
    139. 

  139.                 </div>
    140. 

  140.                 <div class="api-card-body">
    141. 

  141.                     <div class="api-title">删除历史记录</div>
    142. 

  142.                     <div class="api-desc">删除指定的历史记录</div>
    143. 

  143.                     <div class="params-title">请求参数 (Body JSON)</div>
    144. 

  144.                     <div class="param-item"><span class="param-name">id</span> <span class="param-type">uint64</span> - 记录ID</div>
    145. 

  145.                 </div>
    146. 

  146.             </div>
    147. 

  147.             <div class="api-card">
    148. 

  148.                 <div class="api-card-header">
    149. 

  149.                     <span class="method post">POST</span>
    150. 

  150.                     <span class="api-path">/apiv1/intent_recognition</span>
    151. 

  151.                 </div>
    152. 

  152.                 <div class="api-card-body">
    153. 

  153.                     <div class="api-title">意图识别</div>
    154. 

  154.                     <div class="api-desc">识别用户输入的意图类型</div>
    155. 

  155.                     <div class="params-title">请求参数 (Body JSON)</div>
    156. 

  156.                     <div class="param-item"><span class="param-name">message</span> <span class="param-type">string</span> - 用户消息</div>
    157. 

  157.                 </div>
    158. 

  158.             </div>
    159. 

  159.             <div class="api-card">
    160. 

  160.                 <div class="api-card-header">
    161. 

  161.                     <span class="method get">GET</span>
    162. 

  162.                     <span class="api-path">/apiv1/get_chromadb_document</span>
    163. 

  163.                 </div>
    164. 

  164.                 <div class="api-card-body">
    165. 

  165.                     <div class="api-title">获取ChromaDB文档</div>
    166. 

  166.                     <div class="api-desc">从向量数据库检索相关文档并生成回答</div>
    167. 

  167.                     <div class="params-title">请求参数 (Query)</div>
    168. 

  168.                     <div class="param-item"><span class="param-name">query</span> <span class="param-type">string</span> - 查询内容</div>
    169. 

  169.                 </div>
    170. 

  170.             </div>
    171. 

  171.             <div class="api-card">
    172. 

  172.                 <div class="api-card-header">
    173. 

  173.                     <span class="method post">POST</span>
    174. 

  174.                     <span class="api-path">/apiv1/guess_you_want</span>
    175. 

  175.                 </div>
    176. 

  176.                 <div class="api-card-body">
    177. 

  177.                     <div class="api-title">猜你想问</div>
    178. 

  178.                     <div class="api-desc">根据上下文推荐相关问题</div>
    179. 

  179.                     <div class="params-title">请求参数 (Body JSON)</div>
    180. 

  180.                     <div class="param-item"><span class="param-name">context</span> <span class="param-type">string</span> - 上下文内容</div>
    181. 

  181.                 </div>
    182. 

  182.             </div>
    183. 

  183.             <div class="api-card">
    184. 

  184.                 <div class="api-card-header">
    185. 

  185.                     <span class="method get">GET</span>
    186. 

  186.                     <span class="api-path">/apiv1/get_user_recommend_question</span>
    187. 

  187.                 </div>
    188. 

  188.                 <div class="api-card-body">
    189. 

  189.                     <div class="api-title">用户输入推荐问题</div>
    190. 

  190.                     <div class="api-desc">用户输入时实时返回推荐问题</div>
    191. 

  191.                     <div class="params-title">请求参数 (Query)</div>
    192. 

  192.                     <div class="param-item"><span class="param-name">input</span> <span class="param-type">string</span> - 用户输入内容</div>
    193. 

  193.                 </div>
    194. 

  194.             </div>
    195. 

  195.             <div class="api-card">
    196. 

  196.                 <div class="api-card-header">
    197. 

  197.                     <span class="method get">GET</span>
    198. 

  198.                     <span class="api-path">/apiv1/online_search</span>
    199. 

  199.                 </div>
    200. 

  200.                 <div class="api-card-body">
    201. 

  201.                     <div class="api-title">联网搜索</div>
    202. 

  202.                     <div class="api-desc">执行联网搜索获取实时信息</div>
    203. 

  203.                     <div class="params-title">请求参数 (Query)</div>
    204. 

  204.                     <div class="param-item"><span class="param-name">query</span> <span class="param-type">string</span> - 搜索关键词</div>
    205. 

  205.                 </div>
    206. 

  206.             </div>
    207. 

  207.             <div class="api-card">
    208. 

  208.                 <div class="api-card-header">
    209. 

  209.                     <span class="method post">POST</span>
    210. 

  210.                     <span class="api-path">/apiv1/save_online_search_result</span>
    211. 

  211.                 </div>
    212. 

  212.                 <div class="api-card-body">
    213. 

  213.                     <div class="api-title">保存联网搜索结果</div>
    214. 

  214.                     <div class="api-desc">将联网搜索结果存入AIMessage表</div>
    215. 

  215.                     <div class="params-title">请求参数 (Body JSON)</div>
    216. 

  216.                     <div class="param-item"><span class="param-name">content</span> <span class="param-type">string</span> - 搜索结果内容</div>
    217. 

  217.                     <div class="param-item"><span class="param-name">ai_message_id</span> <span class="param-type">uint64</span> - 消息ID</div>
    218. 

  218.                 </div>
    219. 

  219.             </div>
    220. 

  220.         </div>
    221. 

  221. 

  222.         <!-- 考试相关接口 -->
    223. 

  223.         <h2 class="section-title">📝 考试相关接口</h2>
    224. 

  224.         <div class="api-grid">
    225. 

  225.             <div class="api-card">
    226. 

  226.                 <div class="api-card-header">
    227. 

  227.                     <span class="method post">POST</span>
    228. 

  228.                     <span class="api-path">/apiv1/exam/build_prompt</span>
    229. 

  229.                 </div>
    230. 

  230.                 <div class="api-card-body">
    231. 

  231.                     <div class="api-title">生成考试提示词</div>
    232. 

  232.                     <div class="api-desc">根据考试配置生成AI提示词</div>
    233. 

  233.                     <div class="params-title">请求参数 (Body JSON)</div>
    234. 

  234.                     <div class="param-item"><span class="param-name">exam_config</span> <span class="param-type">object</span> - 考试配置对象</div>
    235. 

  235.                 </div>
    236. 

  236.             </div>
    237. 

  237.             <div class="api-card">
    238. 

  238.                 <div class="api-card-header">
    239. 

  239.                     <span class="method post">POST</span>
    240. 

  240.                     <span class="api-path">/apiv1/exam/build_single_prompt</span>
    241. 

  241.                 </div>
    242. 

  242.                 <div class="api-card-body">
    243. 

  243.                     <div class="api-title">单题生成提示词</div>
    244. 

  244.                     <div class="api-desc">为单个题目重新生成提示词</div>
    245. 

  245.                     <div class="params-title">请求参数 (Body JSON)</div>
    246. 

  246.                     <div class="param-item"><span class="param-name">question_type</span> <span class="param-type">string</span> - 题目类型</div>
    247. 

  247.                     <div class="param-item"><span class="param-name">context</span> <span class="param-type">string</span> - 上下文</div>
    248. 

  248.                 </div>
    249. 

  249.             </div>
    250. 

  250.             <div class="api-card">
    251. 

  251.                 <div class="api-card-header">
    252. 

  252.                     <span class="method post">POST</span>
    253. 

  253.                     <span class="api-path">/apiv1/re_modify_question</span>
    254. 

  254.                 </div>
    255. 

  255.                 <div class="api-card-body">
    256. 

  256.                     <div class="api-title">修改考试题目</div>
    257. 

  257.                     <div class="api-desc">修改已生成的考试题目内容</div>
    258. 

  258.                     <div class="params-title">请求参数 (Body JSON)</div>
    259. 

  259.                     <div class="param-item"><span class="param-name">ai_conversation_id</span> <span class="param-type">uint64</span> - 对话ID</div>
    260. 

  260.                     <div class="param-item"><span class="param-name">content</span> <span class="param-type">string</span> - 新内容</div>
    261. 

  261.                 </div>
    262. 

  262.             </div>
    263. 

  263.             <div class="api-card">
    264. 

  264.                 <div class="api-card-header">
    265. 

  265.                     <span class="method post">POST</span>
    266. 

  266.                     <span class="api-path">/apiv1/re_produce_single_question</span>
    267. 

  267.                 </div>
    268. 

  268.                 <div class="api-card-body">
    269. 

  269.                     <div class="api-title">重新生成单题</div>
    270. 

  270.                     <div class="api-desc">重新生成指定的单个考试题目</div>
    271. 

  271.                     <div class="params-title">请求参数 (Body JSON)</div>
    272. 

  272.                     <div class="param-item"><span class="param-name">question_id</span> <span class="param-type">uint64</span> - 题目ID</div>
    273. 

  273.                 </div>
    274. 

  274.             </div>
    275. 

  275.         </div>
    276. 

  276. 

  277.         <!-- 隐患识别接口 -->
    278. 

  278.         <h2 class="section-title">🔍 隐患识别接口</h2>
    279. 

  279.         <div class="api-grid">
    280. 

  280.             <div class="api-card">
    281. 

  281.                 <div class="api-card-header">
    282. 

  282.                     <span class="method post">POST</span>
    283. 

  283.                     <span class="api-path">/apiv1/hazard</span>
    284. 

  284.                 </div>
    285. 

  285.                 <div class="api-card-body">
    286. 

  286.                     <div class="api-title">隐患识别</div>
    287. 

  287.                     <div class="api-desc">使用YOLO模型识别图片中的安全隐患，返回标注后的图片</div>
    288. 

  288.                     <div class="params-title">请求参数 (Body JSON)</div>
    289. 

  289.                     <div class="param-item"><span class="param-name">scene_name</span> <span class="param-type">string</span> - 场景名称(模型类型)</div>
    290. 

  290.                     <div class="param-item"><span class="param-name">image</span> <span class="param-type">string</span> - 图片OSS链接</div>
    291. 

  291.                     <div class="param-item"><span class="param-name">date</span> <span class="param-type">string</span> - 日期</div>
    292. 

  292.                 </div>
    293. 

  293.             </div>
    294. 

  294.             <div class="api-card">
    295. 

  295.                 <div class="api-card-header">
    296. 

  296.                     <span class="method post">POST</span>
    297. 

  297.                     <span class="api-path">/apiv1/save_step</span>
    298. 

  298.                 </div>
    299. 

  299.                 <div class="api-card-body">
    300. 

  300.                     <div class="api-title">保存步骤</div>
    301. 

  301.                     <div class="api-desc">保存PPT生成步骤、JSON文件和封面图</div>
    302. 

  302.                     <div class="params-title">请求参数 (Body JSON)</div>
    303. 

  303.                     <div class="param-item"><span class="param-name">ai_conversation_id</span> <span class="param-type">uint64</span> - 对话ID</div>
    304. 

  304.                     <div class="param-item"><span class="param-name">step</span> <span class="param-type">int</span> - 步骤编号</div>
    305. 

  305.                     <div class="param-item"><span class="param-name">ppt_json_url</span> <span class="param-type">string</span> - PPT JSON URL</div>
    306. 

  306.                     <div class="param-item"><span class="param-name">cover_image</span> <span class="param-type">string</span> - 封面图URL</div>
    307. 

  307.                 </div>
    308. 

  308.             </div>
    309. 

  309.             <div class="api-card">
    310. 

  310.                 <div class="api-card-header">
    311. 

  311.                     <span class="method get">GET</span>
    312. 

  312.                     <span class="api-path">/apiv1/get_history_recognition_record</span>
    313. 

  313.                 </div>
    314. 

  314.                 <div class="api-card-body">
    315. 

  315.                     <div class="api-title">获取识别历史记录</div>
    316. 

  316.                     <div class="api-desc">获取当前用户的隐患识别历史记录</div>
    317. 

  317.                     <div class="params-title">请求参数</div>
    318. 

  318.                     <div class="param-item">无参数，从Token获取用户ID</div>
    319. 

  319.                 </div>
    320. 

  320.             </div>
    321. 

  321.             <div class="api-card">
    322. 

  322.                 <div class="api-card-header">
    323. 

  323.                     <span class="method get">GET</span>
    324. 

  324.                     <span class="api-path">/apiv1/get_recognition_record_detail</span>
    325. 

  325.                 </div>
    326. 

  326.                 <div class="api-card-body">
    327. 

  327.                     <div class="api-title">获取识别记录详情</div>
    328. 

  328.                     <div class="api-desc">获取指定识别记录的详细信息</div>
    329. 

  329.                     <div class="params-title">请求参数 (Query)</div>
    330. 

  330.                     <div class="param-item"><span class="param-name">recognition_record_id</span> <span class="param-type">int64</span> - 记录ID</div>
    331. 

  331.                 </div>
    332. 

  332.             </div>
    333. 

  333.             <div class="api-card">
    334. 

  334.                 <div class="api-card-header">
    335. 

  335.                     <span class="method post">POST</span>
    336. 

  336.                     <span class="api-path">/apiv1/delete_recognition_record</span>
    337. 

  337.                 </div>
    338. 

  338.                 <div class="api-card-body">
    339. 

  339.                     <div class="api-title">删除识别记录</div>
    340. 

  340.                     <div class="api-desc">删除指定的隐患识别历史记录</div>
    341. 

  341.                     <div class="params-title">请求参数 (Body JSON)</div>
    342. 

  342.                     <div class="param-item"><span class="param-name">id</span> <span class="param-type">uint64</span> - 记录ID</div>
    343. 

  343.                 </div>
    344. 

  344.             </div>
    345. 

  345.             <div class="api-card">
    346. 

  346.                 <div class="api-card-header">
    347. 

  347.                     <span class="method post">POST</span>
    348. 

  348.                     <span class="api-path">/apiv1/submit_evaluation</span>
    349. 

  349.                 </div>
    350. 

  350.                 <div class="api-card-body">
    351. 

  351.                     <div class="api-title">提交点评</div>
    352. 

  352.                     <div class="api-desc">用户对识别结果提交点评反馈</div>
    353. 

  353.                     <div class="params-title">请求参数 (Body JSON)</div>
    354. 

  354.                     <div class="param-item"><span class="param-name">id</span> <span class="param-type">uint</span> - 记录ID</div>
    355. 

  355.                     <div class="param-item"><span class="param-name">scene_match</span> <span class="param-type">int</span> - 场景匹配度</div>
    356. 

  356.                     <div class="param-item"><span class="param-name">tip_accuracy</span> <span class="param-type">int</span> - 提示准确度</div>
    357. 

  357.                     <div class="param-item"><span class="param-name">effect_evaluation</span> <span class="param-type">int</span> - 效果评价</div>
    358. 

  358.                     <div class="param-item"><span class="param-name">user_remark</span> <span class="param-type">string</span> - 用户备注</div>
    359. 

  359.                 </div>
    360. 

  360.             </div>
    361. 

  361.             <div class="api-card">
    362. 

  362.                 <div class="api-card-header">
    363. 

  363.                     <span class="method get">GET</span>
    364. 

  364.                     <span class="api-path">/apiv1/get_latest_recognition_record</span>
    365. 

  365.                 </div>
    366. 

  366.                 <div class="api-card-body">
    367. 

  367.                     <div class="api-title">获取最新识别记录</div>
    368. 

  368.                     <div class="api-desc">查询用户最新的一条识别记录是否已点评</div>
    369. 

  369.                     <div class="params-title">请求参数</div>
    370. 

  370.                     <div class="param-item">无参数，从Token获取用户ID</div>
    371. 

  371.                 </div>
    372. 

  372.             </div>
    373. 

  373.             <div class="api-card">
    374. 

  374.                 <div class="api-card-header">
    375. 

  375.                     <span class="method get">GET</span>
    376. 

  376.                     <span class="api-path">/apiv1/get_third_scene_example_image</span>
    377. 

  377.                 </div>
    378. 

  378.                 <div class="api-card-body">
    379. 

  379.                     <div class="api-title">获取三级场景示例图</div>
    380. 

  380.                     <div class="api-desc">获取隐患识别三级场景的正确和错误示例图</div>
    381. 

  381.                     <div class="params-title">请求参数 (Query)</div>
    382. 

  382.                     <div class="param-item"><span class="param-name">third_scene_name</span> <span class="param-type">string</span> - 三级场景名称</div>
    383. 

  383.                 </div>
    384. 

  384.             </div>
    385. 

  385.         </div>
    386. 

  386. 

  387.         <!-- OSS文件上传接口 -->
    388. 

  388.         <h2 class="section-title">📁 OSS文件上传接口</h2>
    389. 

  389.         <div class="api-grid">
    390. 

  390.             <div class="api-card">
    391. 

  391.                 <div class="api-card-header">
    392. 

  392.                     <span class="method post">POST</span>
    393. 

  393.                     <span class="api-path">/apiv1/oss/upload</span>
    394. 

  394.                 </div>
    395. 

  395.                 <div class="api-card-body">
    396. 

  396.                     <div class="api-title">获取上传凭证</div>
    397. 

  397.                     <div class="api-desc">生成S3预签名上传凭证，用于前端直传OSS</div>
    398. 

  398.                     <div class="params-title">响应</div>
    399. 

  399.                     <div class="param-item"><span class="param-name">url</span> - 上传地址</div>
    400. 

  400.                     <div class="param-item"><span class="param-name">fields</span> - 签名字段</div>
    401. 

  401.                     <div class="param-item"><span class="param-name">expire</span> - 过期时间</div>
    402. 

  402.                 </div>
    403. 

  403.             </div>
    404. 

  404.             <div class="api-card">
    405. 

  405.                 <div class="api-card-header">
    406. 

  406.                     <span class="method post">POST</span>
    407. 

  407.                     <span class="api-path">/apiv1/oss/shudao/upload_image</span>
    408. 

  408.                 </div>
    409. 

  409.                 <div class="api-card-body">
    410. 

  410.                     <div class="api-title">上传图片</div>
    411. 

  411.                     <div class="api-desc">上传图片到OSS，自动压缩到200KB以下</div>
    412. 

  412.                     <div class="params-title">请求参数 (FormData)</div>
    413. 

  413.                     <div class="param-item"><span class="param-name">image</span> <span class="param-type">file</span> - 图片文件(≤10MB)</div>
    414. 

  414.                     <div class="params-title" style="margin-top:8px">响应</div>
    415. 

  415.                     <div class="param-item"><span class="param-name">fileUrl</span> - 代理访问URL</div>
    416. 

  416.                     <div class="param-item"><span class="param-name">fileName</span> - 文件名</div>
    417. 

  417.                     <div class="param-item"><span class="param-name">fileSize</span> - 文件大小</div>
    418. 

  418.                 </div>
    419. 

  419.             </div>
    420. 

  420.             <div class="api-card">
    421. 

  421.                 <div class="api-card-header">
    422. 

  422.                     <span class="method post">POST</span>
    423. 

  423.                     <span class="api-path">/apiv1/oss/shudao/upload_json</span>
    424. 

  424.                 </div>
    425. 

  425.                 <div class="api-card-body">
    426. 

  426.                     <div class="api-title">上传PPT JSON文件</div>
    427. 

  427.                     <div class="api-desc">上传PPT配置JSON文件到OSS</div>
    428. 

  428.                     <div class="params-title">请求参数 (FormData)</div>
    429. 

  429.                     <div class="param-item"><span class="param-name">json</span> <span class="param-type">file</span> - JSON文件(≤50MB)</div>
    430. 

  430.                     <div class="params-title" style="margin-top:8px">响应</div>
    431. 

  431.                     <div class="param-item"><span class="param-name">fileUrl</span> - 代理访问URL</div>
    432. 

  432.                 </div>
    433. 

  433.             </div>
    434. 

  434.             <div class="api-card">
    435. 

  435.                 <div class="api-card-header">
    436. 

  436.                     <span class="method get">GET</span>
    437. 

  437.                     <span class="api-path">/apiv1/oss/parse</span>
    438. 

  438.                 </div>
    439. 

  439.                 <div class="api-card-body">
    440. 

  440.                     <div class="api-title">OSS代理解析</div>
    441. 

  441.                     <div class="api-desc">代理转发OSS URL请求，解密并获取文件内容</div>
    442. 

  442.                     <div class="params-title">请求参数 (Query)</div>
    443. 

  443.                     <div class="param-item"><span class="param-name">url</span> <span class="param-type">string</span> - 加密的OSS URL</div>
    444. 

  444.                 </div>
    445. 

  445.             </div>
    446. 

  446.         </div>
    447. 

  447. 

  448.         <!-- 通用功能接口 -->
    449. 

  449.         <h2 class="section-title">🔧 通用功能接口</h2>
    450. 

  450.         <div class="api-grid">
    451. 

  451.             <div class="api-card">
    452. 

  452.                 <div class="api-card-header">
    453. 

  453.                     <span class="method get">GET</span>
    454. 

  454.                     <span class="api-path">/apiv1/recommend_question</span>
    455. 

  455.                 </div>
    456. 

  456.                 <div class="api-card-body">
    457. 

  457.                     <div class="api-title">获取推荐问题</div>
    458. 

  458.                     <div class="api-desc">随机返回推荐问题列表</div>
    459. 

  459.                     <div class="params-title">请求参数 (Query)</div>
    460. 

  460.                     <div class="param-item"><span class="param-name">limit</span> <span class="param-type">int</span> - 数量(默认5)</div>
    461. 

  461.                 </div>
    462. 

  462.             </div>
    463. 

  463.             <div class="api-card">
    464. 

  464.                 <div class="api-card-header">
    465. 

  465.                     <span class="method get">GET</span>
    466. 

  466.                     <span class="api-path">/apiv1/get_function_card</span>
    467. 

  467.                 </div>
    468. 

  468.                 <div class="api-card-body">
    469. 

  469.                     <div class="api-title">获取功能卡片</div>
    470. 

  470.                     <div class="api-desc">随机返回4条功能卡片</div>
    471. 

  471.                     <div class="params-title">请求参数 (Query)</div>
    472. 

  472.                     <div class="param-item"><span class="param-name">function_type</span> <span class="param-type">int</span> - 类型(0:AI问答,1:安全培训)</div>
    473. 

  473.                 </div>
    474. 

  474.             </div>
    475. 

  475.             <div class="api-card">
    476. 

  476.                 <div class="api-card-header">
    477. 

  477.                     <span class="method get">GET</span>
    478. 

  478.                     <span class="api-path">/apiv1/get_hot_question</span>
    479. 

  479.                 </div>
    480. 

  480.                 <div class="api-card-body">
    481. 

  481.                     <div class="api-title">获取热点问题</div>
    482. 

  482.                     <div class="api-desc">随机返回4条热点问题</div>
    483. 

  483.                     <div class="params-title">请求参数 (Query)</div>
    484. 

  484.                     <div class="param-item"><span class="param-name">question_type</span> <span class="param-type">int</span> - 类型(0:AI问答,1:安全培训)</div>
    485. 

  485.                 </div>
    486. 

  486.             </div>
    487. 

  487.             <div class="api-card">
    488. 

  488.                 <div class="api-card-header">
    489. 

  489.                     <span class="method post">POST</span>
    490. 

  490.                     <span class="api-path">/apiv1/submit_feedback</span>
    491. 

  491.                 </div>
    492. 

  492.                 <div class="api-card-body">
    493. 

  493.                     <div class="api-title">提交意见反馈</div>
    494. 

  494.                     <div class="api-desc">用户提交意见反馈信息</div>
    495. 

  495.                     <div class="params-title">请求参数 (Body JSON)</div>
    496. 

  496.                     <div class="param-item"><span class="param-name">content</span> <span class="param-type">string</span> - 反馈内容</div>
    497. 

  497.                     <div class="param-item"><span class="param-name">contact</span> <span class="param-type">string</span> - 联系方式</div>
    498. 

  498.                 </div>
    499. 

  499.             </div>
    500. 

  500.             <div class="api-card">
    501. 

  501.                 <div class="api-card-header">
    502. 

  502.                     <span class="method post">POST</span>
    503. 

  503.                     <span class="api-path">/apiv1/like_and_dislike</span>
    504. 

  504.                 </div>
    505. 

  505.                 <div class="api-card-body">
    506. 

  506.                     <div class="api-title">点赞/踩</div>
    507. 

  507.                     <div class="api-desc">对AI回复进行点赞或踩的反馈</div>
    508. 

  508.                     <div class="params-title">请求参数 (Body JSON)</div>
    509. 

  509.                     <div class="param-item"><span class="param-name">id</span> <span class="param-type">uint</span> - 消息ID</div>
    510. 

  510.                     <div class="param-item"><span class="param-name">user_feedback</span> <span class="param-type">int</span> - 反馈(1:赞,-1:踩)</div>
    511. 

  511.                 </div>
    512. 

  512.             </div>
    513. 

  513.             <div class="api-card">
    514. 

  514.                 <div class="api-card-header">
    515. 

  515.                     <span class="method get">GET</span>
    516. 

  516.                     <span class="api-path">/apiv1/get_user_data_id</span>
    517. 

  517.                 </div>
    518. 

  518.                 <div class="api-card-body">
    519. 

  519.                     <div class="api-title">获取用户数据ID</div>
    520. 

  520.                     <div class="api-desc">根据account_id获取用户数据主键ID</div>
    521. 

  521.                     <div class="params-title">请求参数</div>
    522. 

  522.                     <div class="param-item">无参数，从Token获取account_id</div>
    523. 

  523.                 </div>
    524. 

  524.             </div>
    525. 

  525.         </div>
    526. 

  526. 

  527.         <!-- 政策文件接口 -->
    528. 

  528.         <h2 class="section-title">📄 政策文件接口</h2>
    529. 

  529.         <div class="api-grid">
    530. 

  530.             <div class="api-card">
    531. 

  531.                 <div class="api-card-header">
    532. 

  532.                     <span class="method get">GET</span>
    533. 

  533.                     <span class="api-path">/apiv1/get_policy_file</span>
    534. 

  534.                 </div>
    535. 

  535.                 <div class="api-card-body">
    536. 

  536.                     <div class="api-title">获取政策文件列表</div>
    537. 

  537.                     <div class="api-desc">分页获取政策文件列表，支持类型筛选和搜索</div>
    538. 

  538.                     <div class="params-title">请求参数 (Query)</div>
    539. 

  539.                     <div class="param-item"><span class="param-name">policy_type</span> <span class="param-type">int</span> - 政策类型(0:全部)</div>
    540. 

  540.                     <div class="param-item"><span class="param-name">search</span> <span class="param-type">string</span> - 搜索关键词</div>
    541. 

  541.                     <div class="param-item"><span class="param-name">page</span> <span class="param-type">int</span> - 页码</div>
    542. 

  542.                     <div class="param-item"><span class="param-name">pageSize</span> <span class="param-type">int</span> - 每页数量</div>
    543. 

  543.                 </div>
    544. 

  544.             </div>
    545. 

  545.             <div class="api-card">
    546. 

  546.                 <div class="api-card-header">
    547. 

  547.                     <span class="method get">GET</span>
    548. 

  548.                     <span class="api-path">/apiv1/download_file</span>
    549. 

  549.                 </div>
    550. 

  550.                 <div class="api-card-body">
    551. 

  551.                     <div class="api-title">下载文件</div>
    552. 

  552.                     <div class="api-desc">从OSS链接下载文件并返回给前端</div>
    553. 

  553.                     <div class="params-title">请求参数 (Query)</div>
    554. 

  554.                     <div class="param-item"><span class="param-name">pdf_oss_download_link</span> <span class="param-type">string</span> - OSS下载链接</div>
    555. 

  555.                     <div class="param-item"><span class="param-name">file_name</span> <span class="param-type">string</span> - 自定义文件名(可选)</div>
    556. 

  556.                 </div>
    557. 

  557.             </div>
    558. 

  558.             <div class="api-card">
    559. 

  559.                 <div class="api-card-header">
    560. 

  560.                     <span class="method post">POST</span>
    561. 

  561.                     <span class="api-path">/apiv1/policy_file_count</span>
    562. 

  562.                 </div>
    563. 

  563.                 <div class="api-card-body">
    564. 

  564.                     <div class="api-title">政策文件统计</div>
    565. 

  565.                     <div class="api-desc">政策文件查看和下载次数+1</div>
    566. 

  566.                     <div class="params-title">请求参数 (Body JSON)</div>
    567. 

  567.                     <div class="param-item"><span class="param-name">policy_file_id</span> <span class="param-type">int</span> - 政策文件ID</div>
    568. 

  568.                     <div class="param-item"><span class="param-name">action_type</span> <span class="param-type">int</span> - 操作类型(1:查看,2:下载)</div>
    569. 

  569.                 </div>
    570. 

  570.             </div>
    571. 

  571.             <div class="api-card">
    572. 

  572.                 <div class="api-card-header">
    573. 

  573.                     <span class="method get">GET</span>
    574. 

  574.                     <span class="api-path">/apiv1/get_file_link</span>
    575. 

  575.                 </div>
    576. 

  576.                 <div class="api-card-body">
    577. 

  577.                     <div class="api-title">获取文件链接</div>
    578. 

  578.                     <div class="api-desc">根据文件名从数据库查找对应的OSS链接</div>
    579. 

  579.                     <div class="params-title">请求参数 (Query)</div>
    580. 

  580.                     <div class="param-item"><span class="param-name">file_name</span> <span class="param-type">string</span> - 文件名</div>
    581. 

  581.                 </div>
    582. 

  582.             </div>
    583. 

  583.             <div class="api-card">
    584. 

  584.                 <div class="api-card-header">
    585. 

  585.                     <span class="method get">GET</span>
    586. 

  586.                     <span class="api-path">/apiv1/knowledge/files/advanced-search</span>
    587. 

  587.                 </div>
    588. 

  588.                 <div class="api-card-body">
    589. 

  589.                     <div class="api-title">知识库高级搜索</div>
    590. 

  590.                     <div class="api-desc">从ChromaDB向量数据库进行高级文件搜索</div>
    591. 

  591.                     <div class="params-title">请求参数 (Query)</div>
    592. 

  592.                     <div class="param-item"><span class="param-name">query_str</span> <span class="param-type">string</span> - 查询字符串</div>
    593. 

  593.                     <div class="param-item"><span class="param-name">n_results</span> <span class="param-type">int</span> - 结果数量(默认50)</div>
    594. 

  594.                 </div>
    595. 

  595.             </div>
    596. 

  596.             <div class="api-card">
    597. 

  597.                 <div class="api-card-header">
    598. 

  598.                     <span class="method post">POST</span>
    599. 

  599.                     <span class="api-path">/apiv1/save_ppt_outline</span>
    600. 

  600.                 </div>
    601. 

  601.                 <div class="api-card-body">
    602. 

  602.                     <div class="api-title">保存PPT大纲</div>
    603. 

  603.                     <div class="api-desc">保存AI生成的PPT大纲内容</div>
    604. 

  604.                     <div class="params-title">请求参数 (Body JSON)</div>
    605. 

  605.                     <div class="param-item"><span class="param-name">ai_conversation_id</span> <span class="param-type">uint64</span> - 对话ID</div>
    606. 

  606.                     <div class="param-item"><span class="param-name">outline</span> <span class="param-type">string</span> - 大纲内容</div>
    607. 

  607.                 </div>
    608. 

  608.             </div>
    609. 

  609.             <div class="api-card">
    610. 

  610.                 <div class="api-card-header">
    611. 

  611.                     <span class="method post">POST</span>
    612. 

  612.                     <span class="api-path">/apiv1/save_edit_document</span>
    613. 

  613.                 </div>
    614. 

  614.                 <div class="api-card-body">
    615. 

  615.                     <div class="api-title">保存编辑文档</div>
    616. 

  616.                     <div class="api-desc">AI写作保存编辑后的文档内容</div>
    617. 

  617.                     <div class="params-title">请求参数 (Body JSON)</div>
    618. 

  618.                     <div class="param-item"><span class="param-name">ai_message_id</span> <span class="param-type">uint64</span> - 消息ID</div>
    619. 

  619.                     <div class="param-item"><span class="param-name">content</span> <span class="param-type">string</span> - 文档内容</div>
    620. 

  620.                 </div>
    621. 

  621.             </div>
    622. 

  622.         </div>
    623. 

  623. 

  624.         <!-- 积分系统接口 -->
    625. 

  625.         <h2 class="section-title">💰 积分系统接口</h2>
    626. 

  626.         <div class="api-grid">
    627. 

  627.             <div class="api-card">
    628. 

  628.                 <div class="api-card-header">
    629. 

  629.                     <span class="method get">GET</span>
    630. 

  630.                     <span class="api-path">/apiv1/points/balance</span>
    631. 

  631.                 </div>
    632. 

  632.                 <div class="api-card-body">
    633. 

  633.                     <div class="api-title">获取积分余额</div>
    634. 

  634.                     <div class="api-desc">获取当前用户的积分余额</div>
    635. 

  635.                     <div class="params-title">请求参数</div>
    636. 

  636.                     <div class="param-item">无参数，从Token获取用户ID</div>
    637. 

  637.                     <div class="params-title" style="margin-top:8px">响应</div>
    638. 

  638.                     <div class="param-item"><span class="param-name">points</span> - 积分余额</div>
    639. 

  639.                 </div>
    640. 

  640.             </div>
    641. 

  641.             <div class="api-card">
    642. 

  642.                 <div class="api-card-header">
    643. 

  643.                     <span class="method post">POST</span>
    644. 

  644.                     <span class="api-path">/apiv1/points/consume</span>
    645. 

  645.                 </div>
    646. 

  646.                 <div class="api-card-body">
    647. 

  647.                     <div class="api-title">消费积分</div>
    648. 

  648.                     <div class="api-desc">消费积分下载文件（每次10积分）</div>
    649. 

  649.                     <div class="params-title">请求参数 (Body JSON)</div>
    650. 

  650.                     <div class="param-item"><span class="param-name">file_name</span> <span class="param-type">string</span> - 文件名</div>
    651. 

  651.                     <div class="param-item"><span class="param-name">file_url</span> <span class="param-type">string</span> - 文件URL</div>
    652. 

  652.                     <div class="params-title" style="margin-top:8px">响应</div>
    653. 

  653.                     <div class="param-item"><span class="param-name">new_balance</span> - 新余额</div>
    654. 

  654.                     <div class="param-item"><span class="param-name">points_consumed</span> - 消费积分</div>
    655. 

  655.                 </div>
    656. 

  656.             </div>
    657. 

  657.             <div class="api-card">
    658. 

  658.                 <div class="api-card-header">
    659. 

  659.                     <span class="method get">GET</span>
    660. 

  660.                     <span class="api-path">/apiv1/points/history</span>
    661. 

  661.                 </div>
    662. 

  662.                 <div class="api-card-body">
    663. 

  663.                     <div class="api-title">获取消费记录</div>
    664. 

  664.                     <div class="api-desc">分页获取用户的积分消费历史记录</div>
    665. 

  665.                     <div class="params-title">请求参数 (Query)</div>
    666. 

  666.                     <div class="param-item"><span class="param-name">page</span> <span class="param-type">int</span> - 页码(默认1)</div>
    667. 

  667.                     <div class="param-item"><span class="param-name">pageSize</span> <span class="param-type">int</span> - 每页数量(默认10)</div>
    668. 

  668.                 </div>
    669. 

  669.             </div>
    670. 

  670.         </div>
    671. 

  671. 

  672.         <!-- 埋点记录接口 -->
    673. 

  673.         <h2 class="section-title">📊 埋点记录接口</h2>
    674. 

  674.         <div class="api-grid">
    675. 

  675.             <div class="api-card">
    676. 

  676.                 <div class="api-card-header">
    677. 

  677.                     <span class="method post">POST</span>
    678. 

  678.                     <span class="api-path">/apiv1/tracking/record</span>
    679. 

  679.                 </div>
    680. 

  680.                 <div class="api-card-body">
    681. 

  681.                     <div class="api-title">记录埋点数据</div>
    682. 

  682.                     <div class="api-desc">记录用户行为埋点数据</div>
    683. 

  683.                     <div class="params-title">请求参数 (Body JSON)</div>
    684. 

  684.                     <div class="param-item"><span class="param-name">api_path</span> <span class="param-type">string</span> - 接口路径</div>
    685. 

  685.                     <div class="param-item"><span class="param-name">method</span> <span class="param-type">string</span> - 请求方法</div>
    686. 

  686.                     <div class="param-item"><span class="param-name">extra_data</span> <span class="param-type">string</span> - 额外数据(可选)</div>
    687. 

  687.                 </div>
    688. 

  688.             </div>
    689. 

  689.             <div class="api-card">
    690. 

  690.                 <div class="api-card-header">
    691. 

  691.                     <span class="method get">GET</span>
    692. 

  692.                     <span class="api-path">/apiv1/tracking/records</span>
    693. 

  693.                 </div>
    694. 

  694.                 <div class="api-card-body">
    695. 

  695.                     <div class="api-title">获取埋点记录</div>
    696. 

  696.                     <div class="api-desc">分页获取埋点记录列表</div>
    697. 

  697.                     <div class="params-title">请求参数 (Query)</div>
    698. 

  698.                     <div class="param-item"><span class="param-name">user_id</span> <span class="param-type">int</span> - 用户ID(可选)</div>
    699. 

  699.                     <div class="param-item"><span class="param-name">api_path</span> <span class="param-type">string</span> - 接口路径(可选)</div>
    700. 

  700.                     <div class="param-item"><span class="param-name">page</span> <span class="param-type">int</span> - 页码(默认1)</div>
    701. 

  701.                     <div class="param-item"><span class="param-name">page_size</span> <span class="param-type">int</span> - 每页数量(默认20)</div>
    702. 

  702.                 </div>
    703. 

  703.             </div>
    704. 

  704.             <div class="api-card">
    705. 

  705.                 <div class="api-card-header">
    706. 

  706.                     <span class="method post">POST</span>
    707. 

  707.                     <span class="api-path">/apiv1/tracking/api_mapping</span>
    708. 

  708.                 </div>
    709. 

  709.                 <div class="api-card-body">
    710. 

  710.                     <div class="api-title">添加接口映射</div>
    711. 

  711.                     <div class="api-desc">添加接口路径到名称的映射关系</div>
    712. 

  712.                     <div class="params-title">请求参数 (Body JSON)</div>
    713. 

  713.                     <div class="param-item"><span class="param-name">api_path</span> <span class="param-type">string</span> - 接口路径</div>
    714. 

  714.                     <div class="param-item"><span class="param-name">api_name</span> <span class="param-type">string</span> - 接口名称</div>
    715. 

  715.                     <div class="param-item"><span class="param-name">api_desc</span> <span class="param-type">string</span> - 接口描述(可选)</div>
    716. 

  716.                 </div>
    717. 

  717.             </div>
    718. 

  718.             <div class="api-card">
    719. 

  719.                 <div class="api-card-header">
    720. 

  720.                     <span class="method get">GET</span>
    721. 

  721.                     <span class="api-path">/apiv1/tracking/api_mappings</span>
    722. 

  722.                 </div>
    723. 

  723.                 <div class="api-card-body">
    724. 

  724.                     <div class="api-title">获取接口映射列表</div>
    725. 

  725.                     <div class="api-desc">获取所有接口路径映射关系</div>
    726. 

  726.                     <div class="params-title">请求参数</div>
    727. 

  727.                     <div class="param-item">无参数</div>
    728. 

  728.                 </div>
    729. 

  729.             </div>
    730. 

  730.         </div>
    731. 

  731. 

  732.         <div style="text-align:center; padding:30px; color:#9ca3af; font-size:12px;">
    733. 

  733.             <p>蜀道安全AI系统 API文档 v1.0 | 共 <strong>45</strong> 个接口</p>
    734. 

  734.             <p>基础路径: <code>/apiv1</code> | 认证方式: JWT Token (Header: Authorization)</p>
    735. 

  735.             <p>生成时间: 2024年12月</p>
    736. 

  736.         </div>
    737. 

  737.     </div>
    738. 

  738. </body>
    739. 

  739. </html>
    740.