1

Shared/KBBizCode.h

@@ -0,0 +1,62 @@
+//
+//  KBBizCode.h
+//  服务端业务状态码与通用解析工具
+//
+//  说明：
+//  - 将所有常用的业务 code 集中到这里，避免在项目里到处写裸数字；
+//  - 实际数值请按照你们后端的约定修改；
+//  - 若后端新增/调整 code，只需要维护这一处即可。
+//
+
+#ifndef KBBizCode_h
+#define KBBizCode_h
+
+#import <Foundation/Foundation.h>
+#import "KBAPI.h"  // 引入 SUCCESS_CODE/ERROR_CODE 等基础定义
+
+/// 服务端业务状态码（按项目实际调整）
+typedef NS_ENUM(NSInteger, KBBizCode) {
+    /// 通用成功（通常为 200，对应 SUCCESS_CODE）
+    KBBizCodeSuccess = SUCCESS_CODE,
+
+    /// token 失效/未登录（示例值；请按后端实际 code 修改）
+    KBBizCodeTokenInvalid = 40101,
+
+    /// token 过期（可选；如无区分可与 KBBizCodeTokenInvalid 复用）
+    KBBizCodeTokenExpired = 40102,
+
+    /// 账号在其他设备登录，被服务端强制下线
+    KBBizCodeAccountKicked = 40103,
+};
+
+NS_ASSUME_NONNULL_BEGIN
+
+/// 从 JSON 响应中提取业务 code。
+/// 支持常见字段：code / status / retcode（数字或字符串）。
+/// 若未找到返回 NSNotFound。
+static inline NSInteger KBBizCodeFromJSONObject(id obj) {
+    if (![obj isKindOfClass:NSDictionary.class]) return NSNotFound;
+    NSDictionary *d = (NSDictionary *)obj;
+    id code = d[@"code"] ?: d[@"status"] ?: d[@"retcode"];
+    if ([code isKindOfClass:NSNumber.class]) {
+        return ((NSNumber *)code).integerValue;
+    }
+    if ([code isKindOfClass:NSString.class]) {
+        return ((NSString *)code).integerValue;
+    }
+    return NSNotFound;
+}
+
+/// 从 JSON 响应中提取错误文案，支持 message/msg/error。
+static inline NSString *KBBizMessageFromJSONObject(id obj) {
+    if (![obj isKindOfClass:NSDictionary.class]) return nil;
+    NSDictionary *d = (NSDictionary *)obj;
+    NSString *msg = d[@"message"] ?: d[@"msg"] ?: d[@"error"];
+    if (![msg isKindOfClass:NSString.class]) return nil;
+    return msg;
+}
+
+NS_ASSUME_NONNULL_END
+
+#endif /* KBBizCode_h */
+