e45ad3bad5
- 更新邮箱登录相关功能，新增邮箱验证码获取和登录API端点。 - 添加AccountModel以管理用户认证信息，支持会话票据的存储和更新。 - 实现密码恢复功能，支持通过邮箱获取验证码和重置密码。 - 增加本地化支持，更新相关字符串以适应新功能。 - 引入ValidationHelper以验证邮箱和密码格式，确保用户输入的有效性。 - 更新视图以支持邮箱登录和密码恢复的用户交互。
118 lines
3.7 KiB
Swift
118 lines
3.7 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" // 新增：邮箱验证码获取端点
|
||
// 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（如果存在）
|
||
if let userId = UserInfoManager.getCurrentUserId() {
|
||
headers["pub_uid"] = userId
|
||
}
|
||
|
||
if let userTicket = UserInfoManager.getCurrentUserTicket() {
|
||
headers["pub_ticket"] = userTicket
|
||
}
|
||
|
||
return headers
|
||
}
|
||
}
|
||
|
||
// MARK: - Request Models
|
||
struct LoginRequest: Codable {
|
||
let username: String
|
||
let password: String
|
||
}
|
||
|
||
// MARK: - Empty Request
|
||
struct EmptyRequest: Codable {}
|