fursuit-tv-sdk/com.furrist.rp.furtv.sdk.search/SearchApi

SearchApi

class SearchApi(httpClient: <Error class: unknown class>, baseUrl: String = "https://open-global.vdsentnet.com")

搜索和发现 API 提供热门推荐、随机推荐、搜索、物种查询等发现功能的访问接口

参考官方文档：

  • 热门推荐(../../../../vds-docs/Fursuit.TV 兽频道/发现与搜索 - 推荐能力/热门推荐（furtv.discovery.popular）.md)

  • 随机推荐(../../../../vds-docs/Fursuit.TV 兽频道/发现与搜索 - 推荐能力/随机推荐（furtv.discovery.random）.md)

  • 搜索(../../../../vds-docs/Fursuit.TV 兽频道/发现与搜索 - 检索能力/搜索（furtv.discovery.search）.md)

  • 搜索建议(../../../../vds-docs/Fursuit.TV 兽频道/发现与搜索 - 检索能力/搜索建议（furtv.discovery.search.suggestions）.md)

  • 物种列表(../../../../vds-docs/Fursuit.TV 兽频道/发现与搜索 - 检索能力/物种列表（furtv.discovery.species）.md)

  • 按物种搜索(../../../../vds-docs/Fursuit.TV 兽频道/发现与搜索 - 检索能力/按物种搜索（furtv.discovery.species.search）.md)

  • 热门地区(../../../../vds-docs/Fursuit.TV 兽频道/发现与搜索 - 检索能力/热门地区（furtv.discovery.locations.popular）.md)

Parameters

httpClient

配置好的 HTTP 客户端

baseUrl

API 基础 URL

Constructors

Link copied to clipboard
constructor(httpClient: <Error class: unknown class>, baseUrl: String = "https://open-global.vdsentnet.com")

Functions

Link copied to clipboard
suspend fun getPopular(): PopularData

获取热门推荐 获取当前热门用户列表

Link copied to clipboard
suspend fun getPopularDiscovery(): DiscoveryPopularData

获取热门推荐（Discovery） 获取当前热门用户列表 端点：GET /api/proxy/furtv/discovery/popular

Link copied to clipboard
suspend fun getPopularLocations(): PopularLocationsData

获取热门地区 获取用户数量最多的地区列表 端点：GET /api/proxy/furtv/locations/popular

Link copied to clipboard
suspend fun getPopularLocationsDiscovery(): DiscoveryPopularLocationsData

获取热门地区（Discovery） 获取用户数量最多的地区列表 端点：GET /api/proxy/furtv/discovery/locations/popular

Link copied to clipboard
suspend fun getRandomDiscovery(count: Int? = null, personalized: Boolean? = null): List<DiscoveryRandomUser>

获取随机推荐（Discovery） 获取随机推荐的用户列表，支持个性化推荐 端点：GET /api/proxy/furtv/discovery/random

Link copied to clipboard
suspend fun getRandomFursuit(params: RandomFursuitParams): List<RandomFursuit>

获取随机推荐 获取随机推荐的用户列表，支持个性化推荐 端点：GET /api/proxy/furtv/fursuit/random

suspend fun getRandomFursuit(count: Int? = null, personalized: Boolean? = null): List<RandomFursuit>

获取随机推荐（重载方法，保持向后兼容）

Link copied to clipboard
suspend fun getSearchSuggestions(query: String): List<String>

获取搜索建议 根据关键词获取搜索建议（自动补全） 端点：GET /api/proxy/furtv/search/suggestions

Link copied to clipboard
suspend fun getSearchSuggestionsDiscovery(query: String): List<String>

获取搜索建议（Discovery） 根据关键词获取搜索建议（自动补全） 端点：GET /api/proxy/furtv/discovery/search/suggestions

Link copied to clipboard
suspend fun getSpeciesDiscovery(): DiscoverySpeciesData

获取物种列表（Discovery） 获取所有物种及相关统计信息 端点：GET /api/proxy/furtv/discovery/species

Link copied to clipboard
suspend fun getSpeciesList(): SpeciesListData

获取物种列表 获取所有物种及相关统计信息 端点：GET /api/proxy/furtv/species

Link copied to clipboard
suspend fun search(params: SearchParams): SearchData

搜索 执行搜索操作，支持多种类型和分页 端点：GET /api/proxy/furtv/search

suspend fun search(query: String, type: String? = null, cursor: String? = null, limit: Int? = null): SearchData

搜索（重载方法，保持向后兼容）

Link copied to clipboard
suspend fun searchBySpecies(species: String): SpeciesSearchData

按物种搜索 根据物种名称搜索用户 端点：GET /api/proxy/furtv/search/species/:species

Link copied to clipboard
suspend fun searchBySpeciesDiscovery(params: DiscoverySpeciesSearchParams): DiscoverySpeciesSearchData

按物种搜索（Discovery） 根据物种 ID 搜索用户，支持分页 端点：GET /api/proxy/furtv/discovery/species/search

suspend fun searchBySpeciesDiscovery(speciesId: String, page: Int? = null, pageSize: Int? = null): DiscoverySpeciesSearchData

按物种搜索（Discovery 重载方法）

Link copied to clipboard
suspend fun searchDiscovery(params: DiscoverySearchParams): DiscoverySearchData

搜索（Discovery） 执行搜索操作，支持多种类型和分页 端点：GET /api/proxy/furtv/discovery/search

suspend fun searchDiscovery(query: String, page: Int? = null, pageSize: Int? = null, type: String? = null): DiscoverySearchData

搜索（Discovery 重载方法）