12bb4a5f8c
- 在Podfile中添加Alamofire依赖，并更新Podfile.lock以反映更改。 - 新增动态内容API文档，详细描述`dynamic/square/latestDynamics`接口的请求参数、响应数据结构及示例。 - 实现动态内容的模型和API请求结构，支持获取最新动态列表。 - 更新FeedView和HomeView以集成动态内容展示，增强用户体验。 - 添加动态卡片组件，展示用户动态信息及互动功能。
134 lines
4.5 KiB
Swift
134 lines
4.5 KiB
Swift
import Foundation
|
||
|
||
// MARK: - API Endpoints
|
||
|
||
/// API 端点枚举
|
||
///
|
||
/// 定义了应用中所有可用的 API 端点路径。
|
||
/// 使用枚举确保端点路径的类型安全和统一管理。
|
||
///
|
||
/// 添加新端点时，只需在此枚举中添加新的 case 即可。
|
||
///
|
||
/// 使用示例：
|
||
/// ```swift
|
||
/// let configPath = APIEndpoint.config.path // "/client/config"
|
||
/// ```
|
||
enum APIEndpoint: String, CaseIterable {
|
||
case config = "/client/config"
|
||
case configInit = "/client/init"
|
||
case login = "/oauth/token"
|
||
case ticket = "/oauth/ticket"
|
||
case emailGetCode = "/email/getCode" // 新增：邮箱验证码获取端点
|
||
case latestDynamics = "/dynamic/square/latestDynamics" // 新增：获取最新动态列表端点
|
||
// Web 页面路径
|
||
case userAgreement = "/modules/rule/protocol.html"
|
||
case privacyPolicy = "/modules/rule/privacy-wap.html"
|
||
|
||
var path: String {
|
||
return self.rawValue
|
||
}
|
||
}
|
||
|
||
// MARK: - API Configuration
|
||
|
||
/// API 配置结构体
|
||
///
|
||
/// 集中管理 API 相关的配置参数，包括：
|
||
/// - 服务器地址配置
|
||
/// - 请求超时设置
|
||
/// - 数据大小限制
|
||
/// - 默认请求头设置
|
||
///
|
||
/// 配置特点：
|
||
/// - 支持不同环境的服务器地址
|
||
/// - 防止资源超限的保护机制
|
||
/// - 自动添加认证和设备信息头部
|
||
struct APIConfiguration {
|
||
static var baseURL: String { AppConfig.baseURL }
|
||
static let timeout: TimeInterval = 30.0
|
||
static let maxDataSize: Int = 50 * 1024 * 1024 // 50MB 限制，防止资源超限
|
||
|
||
/// 构建完整的 URL
|
||
/// - Parameter endpoint: API 端点
|
||
/// - Returns: 完整的 URL 字符串
|
||
static func fullURL(for endpoint: APIEndpoint) -> String {
|
||
return baseURL + endpoint.path
|
||
}
|
||
|
||
/// 构建完整的 URL 对象
|
||
/// - Parameter endpoint: API 端点
|
||
/// - Returns: URL 对象，如果构建失败返回 nil
|
||
static func url(for endpoint: APIEndpoint) -> URL? {
|
||
return URL(string: fullURL(for: endpoint))
|
||
}
|
||
|
||
/// 构建Web页面的完整 URL
|
||
/// - Parameter endpoint: API 端点
|
||
/// - Returns: 完整的Web页面 URL 字符串
|
||
static func fullWebURL(for endpoint: APIEndpoint) -> String {
|
||
return baseURL + AppConfig.webPathPrefix + endpoint.path
|
||
}
|
||
|
||
/// 构建Web页面的完整 URL 对象
|
||
/// - Parameter endpoint: API 端点
|
||
/// - Returns: Web页面 URL 对象，如果构建失败返回 nil
|
||
static func webURL(for endpoint: APIEndpoint) -> URL? {
|
||
return URL(string: fullWebURL(for: endpoint))
|
||
}
|
||
|
||
/// 默认请求头配置
|
||
///
|
||
/// 返回所有 API 请求都需要的基础请求头，包括：
|
||
/// - Content-Type 和 Accept 头部
|
||
/// - 压缩支持配置
|
||
/// - 语言和版本信息
|
||
/// - 用户认证信息（如果已登录）
|
||
///
|
||
/// 这些头部会自动添加到每个请求中，确保服务器能够正确处理请求
|
||
static var defaultHeaders: [String: String] {
|
||
var headers = [
|
||
"Content-Type": "application/json",
|
||
"Accept": "application/json",
|
||
"Accept-Encoding": "gzip, br",
|
||
"Accept-Language": Locale.current.languageCode ?? "en",
|
||
"App-Version": Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "1.0.0",
|
||
"User-Agent": "YuMi/20.20.61 (iPhone; iOS 16.4; Scale/2.00)"
|
||
]
|
||
|
||
// 检查用户认证状态并添加相关 headers
|
||
let authStatus = UserInfoManager.checkAuthenticationStatus()
|
||
|
||
if authStatus.canAutoLogin {
|
||
// 添加用户认证相关 headers（仅在 AccountModel 有效时）
|
||
if let userId = UserInfoManager.getCurrentUserId() {
|
||
headers["pub_uid"] = userId
|
||
#if DEBUG
|
||
debugInfo("🔐 添加认证 header: pub_uid = \(userId)")
|
||
#endif
|
||
}
|
||
|
||
if let userTicket = UserInfoManager.getCurrentUserTicket() {
|
||
headers["pub_ticket"] = userTicket
|
||
#if DEBUG
|
||
debugInfo("🔐 添加认证 header: pub_ticket = \(userTicket.prefix(20))...")
|
||
#endif
|
||
}
|
||
} else {
|
||
#if DEBUG
|
||
debugInfo("🔐 跳过认证 header 添加 - 认证状态: \(authStatus.description)")
|
||
#endif
|
||
}
|
||
|
||
return headers
|
||
}
|
||
}
|
||
|
||
// MARK: - Request Models
|
||
struct LoginRequest: Codable {
|
||
let username: String
|
||
let password: String
|
||
}
|
||
|
||
// MARK: - Empty Request
|
||
struct EmptyRequest: Codable {}
|