统一搜索

POST

/api/v1/search/

执行统一全文搜索，支持多种资源类型、过滤和排序选项。本接口支持认证用户（携带 Token）或匿名用户（携带 x-tenant-id 请求头）调用。

Request

Body Params application/jsonRequired

Example

{
    "q": "string",
    "type": "all",
    "size": 20,
    "offset": 0,
    "sort_field": "relevance",
    "sort_order": "asc",
    "filters": {
        "date_from": "2019-08-24T14:15:22.123Z",
        "date_to": "2019-08-24T14:15:22.123Z",
        "category_id": "string",
        "tags": [
            "string"
        ],
        "listing_type": "string",
        "condition": "string",
        "price_min": 0,
        "price_max": 0,
        "errand_status": "string",
        "reward_min": 0,
        "reward_max": 0,
        "activity_type": "string",
        "activity_status": "string",
        "activity_visibility": "string",
        "fee_min": 0,
        "fee_max": 0,
        "start_time_from": "2019-08-24T14:15:22.123Z",
        "start_time_to": "2019-08-24T14:15:22.123Z",
        "school": "string",
        "college": "string",
        "location": "string"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/search/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "q": "string",
    "type": "all",
    "size": 20,
    "offset": 0,
    "sort_field": "relevance",
    "sort_order": "asc",
    "filters": {
        "date_from": "2019-08-24T14:15:22.123Z",
        "date_to": "2019-08-24T14:15:22.123Z",
        "category_id": "string",
        "tags": [
            "string"
        ],
        "listing_type": "string",
        "condition": "string",
        "price_min": 0,
        "price_max": 0,
        "errand_status": "string",
        "reward_min": 0,
        "reward_max": 0,
        "activity_type": "string",
        "activity_status": "string",
        "activity_visibility": "string",
        "fee_min": 0,
        "fee_max": 0,
        "start_time_from": "2019-08-24T14:15:22.123Z",
        "start_time_to": "2019-08-24T14:15:22.123Z",
        "school": "string",
        "college": "string",
        "location": "string"
    }
}'

Responses

🟢200成功

application/json

Successful Response

Body

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "items": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "hot_queries": [
            "string"
        ],
        "total": 0,
        "search_time": 0
    }
}

🟠422无法处理的实体

Modified at 2025-09-26 15:37:19

获取操作状态

获取搜索建议