Sign in
条目

条目搜索

Changed on

实验性 API， 本 schema 和实际的 API 行为都可能随时发生改动

目前支持的筛选条件包括:

  • type: 条目类型，参照 SubjectType enum， 或。
  • tag: 标签，可以多次出现。且 关系。
  • air_date: 播出日期/发售日期。且 关系。
  • rating: 用于搜索指定评分的条目。且 关系。
  • rating_count: 用于按照评分人数筛选条目。且 关系。
  • rank: 用于搜索指定排名的条目。且 关系。
  • nsfw: 使用 include 包含NSFW搜索结果。默认排除搜索NSFW条目。无权限情况下忽略此选项，不会返回NSFW条目。

不同筛选条件之间为 且

post/v0/search/subjects

Request

  • The document declares no server URL.
  • Auth: none declared

Query parameters

limitinteger

分页参数

offsetinteger

分页参数

Request body

keywordstring required
sort'match' | 'heat' | 'rank' | 'score'

排序规则

  • match meilisearch 的默认排序，按照匹配程度
  • heat 收藏人数
  • rank 排名由高到低
  • score 评分

Example request

{
  "sort": "rank",
  "filter": {
    "type": [
      2
    ],
    "meta_tags": [
      "童年",
      "原创"
    ],
    "tag": [
      "童年",
      "原创"
    ],
    "air_date": [
      ">=2020-07-01",
      "<2020-10-01"
    ],
    "rating": [
      ">=6",
      "<8"
    ],
    "rating_count": [
      ">=200",
      "<5000"
    ],
    "rank": [
      ">10",
      "<=18"
    ]
  }
}

Response

返回搜索结果

totalinteger
limitinteger
offsetinteger
dataSubject[] (unresolved $ref)

Changes

  • v04799f5956a7fRevision changes
    • ○

      added the new optional request property /

  • v010c7529c333cRevision changes
    • ▲

      the response property // became optional for the status

    • ▲

      removed the required property // from the response with the status

    • ▲

      removed the required property // from the response with the status

    • ▲

      removed the required property // from the response with the status

    • ○

      added the optional property // to the response with the status

    • ○

      added to the // response property allOf list for the response status

    • ○

      the response property // became required for the status

    • ○

      the response's property default value was added for the status

    • ○

      the response's property default value 0 was added for the status

    • ○

      the response's property default value 0 was added for the status

    • ○

      the response's property default value 0 was added for the status

    • ○

      removed the 1.00 enum value from the // response property for the response status

    • ○

      removed the 2.00 enum value from the // response property for the response status

    • ○

      removed the 3.00 enum value from the // response property for the response status

    • ○

      removed the 4.00 enum value from the // response property for the response status

    • ○

      removed the 6.00 enum value from the // response property for the response status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status