1

keyBoard/Class/Network/KBNetworkManager.h

@@ -79,6 +79,28 @@ typedef void(^KBNetworkDataCompletion)(NSData *_Nullable data,
                                 headers:(nullable NSDictionary<NSString *, NSString *> *)headers
                               completion:(KBNetworkCompletion)completion;
 
+/// 上传文件（multipart/form-data，表单字段名固定为 "file"）
+/// path: 例如 @"file/upload" 或 @"/file/upload"
+/// fileData: 文件二进制数据（比如 UIImageJPEGRepresentation）
+/// fileName: 例如 @"avatar.jpg"
+/// mimeType: 例如 @"image/jpeg"
+- (nullable NSURLSessionDataTask *)uploadFile:(NSString *)path
+                                     fileData:(NSData *)fileData
+                                     fileName:(NSString *)fileName
+                                     mimeType:(NSString *)mimeType
+                                      headers:(nullable NSDictionary<NSString *, NSString *> *)headers
+                         autoShowBusinessError:(BOOL)autoShowBusinessError
+                                    completion:(KBNetworkCompletion)completion;
+
+/// 便捷版本：默认 autoShowBusinessError = YES
+- (nullable NSURLSessionDataTask *)uploadFile:(NSString *)path
+                                     fileData:(NSData *)fileData
+                                     fileName:(NSString *)fileName
+                                     mimeType:(NSString *)mimeType
+                                      headers:(nullable NSDictionary<NSString *, NSString *> *)headers
+                                    completion:(KBNetworkCompletion)completion;
+
+
 @end
 
 NS_ASSUME_NONNULL_END