动作搜索 API：查询规则与 6 种语言

携带 API 密钥并发送 q。缺少 q 的请求会返回 400 错误。结果使用与列表接口相同的 { data, pagination } 外层，按相关度排序，相关度相同时按 id 排序。每页默认 50 条，最多 100 条。

curl -H "Authorization: Bearer fed_live_YOUR_KEY" \
  "https://api.fitexercisedb.com/v1/exercises/search?q=squat&pageSize=10&lang=fr"

每条结果都包含响应字段参考中描述的全部字段。底层是对动作名称、目标肌群和器械的 PostgreSQL 全文查询，除此之外不会索引其他内容。

索引使用 PostgreSQL 的 simple 文本配置，它只转为小写，不做词干还原；查询由 plainto_tsquery 构建，它要求每个词都出现。因此查询只匹配完整单词，你发送的每个词都必须存在。

如需输入联想，可以一次性加载你关心的分类和名称，缓存后在本地过滤，最后再用搜索接口做最终查询。编码之前，不妨先在动作数据库里试几个查询，了解数据内容。

不能靠翻译你的查询实现。被索引的文本是英文的名称、目标肌群和器械，翻译后的名称不在索引中，所以其他语言的词只有在恰好与英文拼写相同时才会匹配。lang 参数改变的是返回的内容，而不是匹配的对象。

本地化搜索框的可行做法是：先自行把用户输入翻译成英文词，再向 API 请求对应语言的文本：

// The user types in French. You map it to English terms, then ask for French text back.
const q = toEnglish("développé couché");        // your own mapping: "bench press"
const url = `/v1/exercises/search?q=${encodeURIComponent(q)}&lang=fr`;

常见场景可以干脆不用自由文本：提供部位、肌群和器械的下拉列表，以英文取值作为键，再显示翻译后的标签。

系统按顺序检查三个来源，取第一个受支持的，任何情况都不会报错：

地区后缀会被忽略，所以 fr-FR 和 pt-BR 分别解析为 fr 和 pt。请求头按书写顺序扫描，采用第一个受支持的标签，不比较质量权重。de 这样的取值不受支持，会悄悄回退到英语。每个响应都会说明所用语言：

Content-Language: fr
Vary: Accept-Language

由于同一个 URL 会因 Accept-Language 不同而返回不同文本，请把语言加入缓存键，或者显式发送 lang。

最后一行就是陷阱。法语响应会把胸部显示为 Poitrine，但筛选参数需要的是 Chest：

# the filter value stays English, the labels come back in French
curl -H "Authorization: Bearer fed_live_YOUR_KEY" \
  "https://api.fitexercisedb.com/v1/exercises?bodyPart=Chest&lang=fr"

请在不带 lang 的情况下获取一次筛选列表，并把这些取值当作键保存；完整列表见文档。