跳转到内容

搜索

搜索覆盖单个目录服务器的乐曲、卡牌、角色、活动、招募、故事和道具。查询会匹配所有语言,所以 千早爱音、千早愛音 和 Anon Chihaya 都能找到同一个角色。

GET /api/v1/search
尚未发送
名称必填含义
q是搜索文本,最多 200 个字符
server是jp 或 intl
locale是返回标题的语言:ja、en、zh-TW、zh-CN 或 ko
section否catalog 或 stories
kind否kinds 中的某一类,例如 songs
limit否1–50,默认 20
offset否0–1000
字段含义
total本次查询的匹配数
kinds各类的匹配数,可用于筛选标签
hits[].title、excerpt已转义的 HTML,匹配部分在 <mark> 中
hits[].urlhaneoka.org 上的页面路径
hits[].kind、section结果的类型
hits[].image缩略图(如有)
  • 所有词都必须匹配;没有结果时改为匹配任意一词。
  • 拼错的拉丁词会用词干重试,所以 Mujika 能找到 Ave Mujica。
  • 简体、繁体和日文字形视为同一个字。
  • 实体本身排在最前:先是角色和乐曲,然后是卡牌和活动,最后是贴纸和道具。

社区帖子不包含在内,因为帖子是否可见取决于读者身份。请用 GET /api/v1/community/posts?q= 搜索帖子。

503 表示索引尚未就绪,请稍后再试。