api_service.dart 9.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249
  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? questionType,
  90. String? importType,
  91. String? annotated,
  92. int page = 1,
  93. int pageSize = 20,
  94. }) async {
  95. final params = <String, dynamic>{
  96. 'page': page,
  97. 'page_size': pageSize,
  98. };
  99. if (chapter != null && chapter.isNotEmpty) params['chapter'] = chapter;
  100. if (questionType != null && questionType.isNotEmpty) params['question_type'] = questionType;
  101. if (importType != null && importType.isNotEmpty) params['import_type'] = importType;
  102. if (annotated != null && annotated.isNotEmpty) params['annotated'] = annotated;
  103. final response = await _dio.get('/api/problems', queryParameters: params, options: _authOptions);
  104. return response.data;
  105. }
  106. // ── 题目详情 ──────────────────────────────────────
  107. Future<Map<String, dynamic>> problemDetail(String id) async {
  108. final response = await _dio.get('/api/problems/$id', options: _authOptions);
  109. return response.data;
  110. }
  111. // ── 题目渲染 ──────────────────────────────────────
  112. Future<Map<String, dynamic>> renderProblem(String id, {bool includeAnswer = true}) async {
  113. final response = await _dio.get(
  114. '/api/problems/$id/render',
  115. queryParameters: {'include_answer': includeAnswer},
  116. options: _authOptions,
  117. );
  118. return response.data;
  119. }
  120. // ── 搜索 ──────────────────────────────────────────
  121. Future<Map<String, dynamic>> search(String query, {int page = 1, int pageSize = 20}) async {
  122. final response = await _dio.get(
  123. '/api/search',
  124. queryParameters: {'q': query, 'page': page, 'page_size': pageSize},
  125. options: _authOptions,
  126. );
  127. return response.data;
  128. }
  129. // ── 元数据更新 ────────────────────────────────────
  130. Future<void> updateMetadata(String id, Map<String, dynamic> fields) async {
  131. await _dio.put('/api/problems/$id/metadata', data: fields, options: _authOptions);
  132. }
  133. Future<void> updateKnowledge(String id, List<String> codes) async {
  134. await _dio.put('/api/problems/$id/knowledge', data: {'knowledge_codes': codes}, options: _authOptions);
  135. }
  136. // ── 连续标注导航 ──────────────────────────────────
  137. Future<Map<String, dynamic>> nextUnannotated({String? currentId, String direction = 'next'}) async {
  138. final params = <String, dynamic>{'direction': direction};
  139. if (currentId != null) params['current_id'] = currentId;
  140. final response = await _dio.get('/api/problems/next-unannotated', queryParameters: params, options: _authOptions);
  141. return response.data;
  142. }
  143. // ── 导入 ──────────────────────────────────────────
  144. Future<Map<String, dynamic>> importDocx(String filePath, String importType) async {
  145. final formData = FormData.fromMap({
  146. 'file': await MultipartFile.fromFile(filePath, filename: filePath.split('/').last),
  147. 'import_type': importType,
  148. });
  149. final response = await _dio.post('/api/import', data: formData, options: _authOptions);
  150. return response.data;
  151. }
  152. Future<Map<String, dynamic>> importStatus(String taskId) async {
  153. final response = await _dio.get('/api/import/$taskId/status', options: _authOptions);
  154. return response.data;
  155. }
  156. // ── 导出 ──────────────────────────────────────────
  157. Future<Map<String, dynamic>> exportChapter(String? chapter, String? importType, String title) async {
  158. final response = await _dio.post('/api/export/chapter',
  159. data: {'chapter': chapter, 'import_type': importType, 'title': title},
  160. options: _authOptions);
  161. return response.data;
  162. }
  163. Future<Map<String, dynamic>> exportCart(int cartId, String title) async {
  164. final response = await _dio.post('/api/export/cart/$cartId',
  165. data: {'title': title}, options: _authOptions);
  166. return response.data;
  167. }
  168. String get downloadUrl => '$_baseUrl/api/exports/';
  169. // ── 知识点 ────────────────────────────────────────
  170. Future<Map<String, dynamic>> knowledgeTree() async {
  171. final response = await _dio.get('/api/knowledge/tree', options: _authOptions);
  172. return response.data;
  173. }
  174. Future<Map<String, dynamic>> searchKnowledge(String query) async {
  175. final response = await _dio.get('/api/knowledge/search', queryParameters: {'q': query}, options: _authOptions);
  176. return response.data;
  177. }
  178. // ── 试题篮 ────────────────────────────────────────
  179. Future<Map<String, dynamic>> listCarts() async {
  180. final response = await _dio.get('/api/carts', options: _authOptions);
  181. return response.data;
  182. }
  183. Future<Map<String, dynamic>> createCart(String name) async {
  184. final response = await _dio.post('/api/carts', data: {'name': name}, options: _authOptions);
  185. return response.data;
  186. }
  187. Future<void> deleteCart(int id) async {
  188. await _dio.delete('/api/carts/$id', options: _authOptions);
  189. }
  190. Future<Map<String, dynamic>> cartDetail(int id) async {
  191. final response = await _dio.get('/api/carts/$id', options: _authOptions);
  192. return response.data;
  193. }
  194. Future<void> addToCart(int cartId, String problemId) async {
  195. await _dio.post('/api/carts/$cartId/items', data: {'problem_id': problemId}, options: _authOptions);
  196. }
  197. Future<void> removeFromCart(int cartId, String problemId) async {
  198. await _dio.delete('/api/carts/$cartId/items/$problemId', options: _authOptions);
  199. }
  200. }