123 lines
4.4 KiB
Swift
123 lines
4.4 KiB
Swift
//
|
||
// SampleManagementAPI.swift
|
||
// suixinkan
|
||
//
|
||
|
||
import Foundation
|
||
|
||
/// 样片管理服务协议，抽象列表、详情、上下架、上传与关联数据接口。
|
||
@MainActor
|
||
protocol SampleManagementServing {
|
||
/// 拉取样片列表。
|
||
func list(status: Int, keyword: String?, page: Int, pageSize: Int) async throws -> SampleMaterialListResponse
|
||
|
||
/// 拉取样片详情。
|
||
func detail(id: Int) async throws -> SampleDetail
|
||
|
||
/// 设置样片上下架状态。
|
||
func setListingStatus(id: Int, listingStatus: Int) async throws
|
||
|
||
/// 上传样片相册。
|
||
func upload(_ request: SampleUploadMaterialRequest) async throws
|
||
|
||
/// 拉取景区全部打卡点。
|
||
func scenicSpotListAll(scenicId: String) async throws -> ScenicSpotListResponse
|
||
|
||
/// 拉取当前景区项目列表。
|
||
func projectList(scenicId: String, name: String?, page: Int, pageSize: Int) async throws -> SampleProjectListResponse
|
||
}
|
||
|
||
/// 样片管理 API，封装 Android `NetworkApi` 中 media-album 与项目接口。
|
||
@MainActor
|
||
final class SampleManagementAPI: SampleManagementServing {
|
||
private let client: APIClient
|
||
|
||
/// 初始化样片管理 API。
|
||
init(client: APIClient) {
|
||
self.client = client
|
||
}
|
||
|
||
/// 拉取样片列表，固定 `type=2`。
|
||
func list(status: Int, keyword: String?, page: Int = 1, pageSize: Int = 10) async throws -> SampleMaterialListResponse {
|
||
var items = [
|
||
URLQueryItem(name: "status", value: String(status)),
|
||
URLQueryItem(name: "type", value: "2"),
|
||
URLQueryItem(name: "page", value: String(max(page, 1))),
|
||
URLQueryItem(name: "page_size", value: String(max(pageSize, 1))),
|
||
]
|
||
if let keyword = keyword?.trimmingCharacters(in: .whitespacesAndNewlines), !keyword.isEmpty {
|
||
items.append(URLQueryItem(name: "keyword", value: keyword))
|
||
}
|
||
return try await client.send(
|
||
APIRequest(method: .get, path: "/api/app/media-album/list", queryItems: items)
|
||
)
|
||
}
|
||
|
||
/// 拉取样片详情，固定 `type=2`。
|
||
func detail(id: Int) async throws -> SampleDetail {
|
||
try await client.send(
|
||
APIRequest(
|
||
method: .get,
|
||
path: "/api/app/media-album/detail",
|
||
queryItems: [
|
||
URLQueryItem(name: "id", value: String(id)),
|
||
URLQueryItem(name: "type", value: "2"),
|
||
]
|
||
)
|
||
)
|
||
}
|
||
|
||
/// 设置样片上下架状态，固定 `type=2`。
|
||
func setListingStatus(id: Int, listingStatus: Int) async throws {
|
||
let _: EmptyPayload = try await client.send(
|
||
APIRequest(
|
||
method: .post,
|
||
path: "/api/app/media-album/operation",
|
||
queryItems: [
|
||
URLQueryItem(name: "id", value: String(id)),
|
||
URLQueryItem(name: "listing_status", value: String(listingStatus)),
|
||
URLQueryItem(name: "type", value: "2"),
|
||
]
|
||
)
|
||
)
|
||
}
|
||
|
||
/// 上传样片相册。
|
||
func upload(_ request: SampleUploadMaterialRequest) async throws {
|
||
let _: EmptyPayload = try await client.send(
|
||
APIRequest(method: .post, path: "/api/app/media-album/upload", body: request)
|
||
)
|
||
}
|
||
|
||
/// 拉取景区全部打卡点。
|
||
func scenicSpotListAll(scenicId: String) async throws -> ScenicSpotListResponse {
|
||
try await client.send(
|
||
APIRequest(
|
||
method: .get,
|
||
path: "/api/yf-handset-app/photog/scenic-spot/list-all",
|
||
queryItems: [URLQueryItem(name: "scenic_id", value: scenicId)]
|
||
)
|
||
)
|
||
}
|
||
|
||
/// 拉取当前景区项目列表。
|
||
func projectList(
|
||
scenicId: String,
|
||
name: String? = nil,
|
||
page: Int = 1,
|
||
pageSize: Int = 10
|
||
) async throws -> SampleProjectListResponse {
|
||
var items = [
|
||
URLQueryItem(name: "scenic_id", value: scenicId),
|
||
URLQueryItem(name: "page", value: String(max(page, 1))),
|
||
URLQueryItem(name: "page_size", value: String(max(pageSize, 1))),
|
||
]
|
||
if let name = name?.trimmingCharacters(in: .whitespacesAndNewlines), !name.isEmpty {
|
||
items.append(URLQueryItem(name: "name", value: name))
|
||
}
|
||
return try await client.send(
|
||
APIRequest(method: .get, path: "/api/yf-handset-app/photog/project/list", queryItems: items)
|
||
)
|
||
}
|
||
}
|