api_service.dart 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276
  1. /// API 服务 — 封装所有 HTTP 请求
  2. import 'dart:convert';
  3. import 'package:crypto/crypto.dart';
  4. import 'package:dio/dio.dart';
  5. import 'package:shared_preferences/shared_preferences.dart';
  6. class ApiService {
  7. late final Dio _dio;
  8. String? _baseUrl;
  9. String? _token;
  10. String? get token => _token;
  11. String? get baseUrl => _baseUrl;
  12. ApiService() {
  13. _dio = Dio(BaseOptions(
  14. connectTimeout: const Duration(seconds: 10),
  15. receiveTimeout: const Duration(seconds: 30),
  16. headers: {'Content-Type': 'application/json'},
  17. ));
  18. // 签名拦截器:给每个 API 请求加上客户端签名
  19. _dio.interceptors.add(InterceptorsWrapper(
  20. onRequest: (options, handler) {
  21. if (_token != null && !options.path.contains('/auth/verify') &&
  22. !options.path.contains('/health')) {
  23. final ts = DateTime.now().millisecondsSinceEpoch ~/ 1000;
  24. final payload = utf8.encode('${options.method}${options.path}$ts');
  25. final key = utf8.encode(_token!);
  26. final sig = Hmac(sha256, key).convert(payload);
  27. final sigHex = sig.bytes.map((b) => b.toRadixString(16).padLeft(2, '0')).join();
  28. options.headers['X-Timestamp'] = '$ts';
  29. options.headers['X-Signature'] = sigHex;
  30. }
  31. handler.next(options);
  32. },
  33. ));
  34. _dio.interceptors.add(LogInterceptor(requestBody: false, responseBody: false));
  35. }
  36. // ── 连接配置 ──────────────────────────────────────
  37. bool get isConfigured => _baseUrl != null && _token != null;
  38. Future<void> loadConfig() async {
  39. final prefs = await SharedPreferences.getInstance();
  40. _baseUrl = prefs.getString('server_url');
  41. _token = prefs.getString('api_token');
  42. if (_baseUrl != null) {
  43. _dio.options.baseUrl = _baseUrl!;
  44. }
  45. }
  46. Future<void> saveConfig(String url, String token) async {
  47. _baseUrl = url.endsWith('/') ? url.substring(0, url.length - 1) : url;
  48. _token = token;
  49. _dio.options.baseUrl = _baseUrl!;
  50. final prefs = await SharedPreferences.getInstance();
  51. await prefs.setString('server_url', _baseUrl!);
  52. await prefs.setString('api_token', token);
  53. }
  54. Future<bool> verifyToken(String url, String token) async {
  55. try {
  56. final testDio = Dio(BaseOptions(
  57. baseUrl: url.endsWith('/') ? url.substring(0, url.length - 1) : url,
  58. connectTimeout: const Duration(seconds: 5),
  59. ));
  60. final response = await testDio.post('/api/auth/verify', data: {'token': token});
  61. return response.data['valid'] == true;
  62. } catch (_) {
  63. return false;
  64. }
  65. }
  66. Future<void> clearConfig() async {
  67. _baseUrl = null;
  68. _token = null;
  69. final prefs = await SharedPreferences.getInstance();
  70. await prefs.remove('server_url');
  71. await prefs.remove('api_token');
  72. }
  73. Options get _authOptions => Options(headers: {
  74. 'Authorization': 'Bearer $_token',
  75. });
  76. // ── 健康检查 ──────────────────────────────────────
  77. Future<Map<String, dynamic>> health() async {
  78. final response = await _dio.get('/api/health');
  79. return response.data;
  80. }
  81. // ── 统计 ──────────────────────────────────────────
  82. Future<Map<String, dynamic>> stats() async {
  83. final response = await _dio.get('/api/stats', options: _authOptions);
  84. return response.data;
  85. }
  86. // ── 题目列表 ──────────────────────────────────────
  87. Future<Map<String, dynamic>> listProblems({
  88. String? chapter,
  89. String? knowledgeCode,
  90. String? questionType,
  91. String? importType,
  92. String? annotated,
  93. int page = 1,
  94. int pageSize = 20,
  95. }) async {
  96. final params = <String, dynamic>{
  97. 'page': page,
  98. 'page_size': pageSize,
  99. };
  100. if (chapter != null && chapter.isNotEmpty) params['chapter'] = chapter;
  101. if (knowledgeCode != null && knowledgeCode.isNotEmpty) params['knowledge_code'] = knowledgeCode;
  102. if (questionType != null && questionType.isNotEmpty) params['question_type'] = questionType;
  103. if (importType != null && importType.isNotEmpty) params['import_type'] = importType;
  104. if (annotated != null && annotated.isNotEmpty) params['annotated'] = annotated;
  105. final response = await _dio.get('/api/problems', queryParameters: params, options: _authOptions);
  106. return response.data;
  107. }
  108. // WebDAV
  109. Future<Map<String, dynamic>> getWebDAVConfig() async {
  110. final response = await _dio.get('/api/admin/backup-config', options: _authOptions);
  111. return response.data;
  112. }
  113. Future<void> setWebDAVConfig(String url, String username, String password) async {
  114. await _dio.put('/api/admin/backup-config',
  115. data: {'url': url, 'username': username, 'password': password},
  116. options: _authOptions);
  117. }
  118. Future<void> triggerFullBackup() async {
  119. await _dio.post('/api/admin/full-backup', options: _authOptions);
  120. }
  121. // ── 题目详情 ──────────────────────────────────────
  122. Future<Map<String, dynamic>> problemDetail(String id) async {
  123. final response = await _dio.get('/api/problems/$id', options: _authOptions);
  124. return response.data;
  125. }
  126. // ── 题目渲染 ──────────────────────────────────────
  127. Future<Map<String, dynamic>> renderProblem(String id, {bool includeAnswer = true}) async {
  128. final response = await _dio.get(
  129. '/api/problems/$id/render',
  130. queryParameters: {'include_answer': includeAnswer},
  131. options: _authOptions,
  132. );
  133. return response.data;
  134. }
  135. // ── 搜索 ──────────────────────────────────────────
  136. Future<Map<String, dynamic>> search(String query, {int page = 1, int pageSize = 20}) async {
  137. final response = await _dio.get(
  138. '/api/search',
  139. queryParameters: {'q': query, 'page': page, 'page_size': pageSize},
  140. options: _authOptions,
  141. );
  142. return response.data;
  143. }
  144. // ── 元数据更新 ────────────────────────────────────
  145. Future<void> updateMetadata(String id, Map<String, dynamic> fields) async {
  146. await _dio.put('/api/problems/$id/metadata', data: fields, options: _authOptions);
  147. }
  148. Future<void> updateKnowledge(String id, List<String> codes) async {
  149. await _dio.put('/api/problems/$id/knowledge', data: {'knowledge_codes': codes}, options: _authOptions);
  150. }
  151. // ── 连续标注导航 ──────────────────────────────────
  152. Future<Map<String, dynamic>> nextUnannotated({String? currentId, String direction = 'next'}) async {
  153. final params = <String, dynamic>{'direction': direction};
  154. if (currentId != null) params['current_id'] = currentId;
  155. final response = await _dio.get('/api/problems/next-unannotated', queryParameters: params, options: _authOptions);
  156. return response.data;
  157. }
  158. // ── 导入 ──────────────────────────────────────────
  159. Future<Map<String, dynamic>> importDocx(String filePath, String importType) async {
  160. final formData = FormData.fromMap({
  161. 'file': await MultipartFile.fromFile(filePath, filename: filePath.split('/').last),
  162. 'import_type': importType,
  163. });
  164. final response = await _dio.post('/api/import', data: formData, options: _authOptions);
  165. return response.data;
  166. }
  167. Future<Map<String, dynamic>> importStatus(String taskId) async {
  168. final response = await _dio.get('/api/import/$taskId/status', options: _authOptions);
  169. return response.data;
  170. }
  171. // ── 导出 ──────────────────────────────────────────
  172. Future<Map<String, dynamic>> exportChapter(String? chapter, String? importType, String title) async {
  173. final response = await _dio.post('/api/export/chapter',
  174. data: {'chapter': chapter, 'import_type': importType, 'title': title},
  175. options: _authOptions);
  176. return response.data;
  177. }
  178. Future<Map<String, dynamic>> exportCart(int cartId, String title) async {
  179. final response = await _dio.post('/api/export/cart/$cartId',
  180. data: {'title': title}, options: _authOptions);
  181. return response.data;
  182. }
  183. String get downloadUrl => '$_baseUrl/api/exports/';
  184. Future<String> downloadExport(String filename, String savePath) async {
  185. await _dio.download('/api/exports/$filename', savePath, options: _authOptions);
  186. return savePath;
  187. }
  188. // ── 知识点 ────────────────────────────────────────
  189. Future<Map<String, dynamic>> knowledgeTree() async {
  190. final response = await _dio.get('/api/knowledge/tree', options: _authOptions);
  191. return response.data;
  192. }
  193. Future<Map<String, dynamic>> searchKnowledge(String query) async {
  194. final response = await _dio.get('/api/knowledge/search', queryParameters: {'q': query}, options: _authOptions);
  195. return response.data;
  196. }
  197. // ── 试题篮 ────────────────────────────────────────
  198. Future<Map<String, dynamic>> listCarts() async {
  199. final response = await _dio.get('/api/carts', options: _authOptions);
  200. return response.data;
  201. }
  202. Future<Map<String, dynamic>> createCart(String name) async {
  203. final response = await _dio.post('/api/carts', data: {'name': name}, options: _authOptions);
  204. return response.data;
  205. }
  206. Future<void> deleteCart(int id) async {
  207. await _dio.delete('/api/carts/$id', options: _authOptions);
  208. }
  209. Future<Map<String, dynamic>> cartDetail(int id) async {
  210. final response = await _dio.get('/api/carts/$id', options: _authOptions);
  211. return response.data;
  212. }
  213. Future<void> addToCart(int cartId, String problemId) async {
  214. await _dio.post('/api/carts/$cartId/items', data: {'problem_id': problemId}, options: _authOptions);
  215. }
  216. Future<void> removeFromCart(int cartId, String problemId) async {
  217. await _dio.delete('/api/carts/$cartId/items/$problemId', options: _authOptions);
  218. }
  219. Future<void> clearCart(int cartId) async {
  220. await _dio.post('/api/carts/$cartId/clear', options: _authOptions);
  221. }
  222. }