词典

词典推荐语

0次调用
1 积分/次

想在查词框里加上“边输入边联想”的丝滑体验?用户刚敲下几个字母,就能立刻看到相关的候选词,这就是这个接口的拿手好戏。

功能概述

传入用户正在输入的前缀 q(也兼容参数名 word),接口会快速返回一组匹配的候选单词,并附带简短的中文释义。用户选中某个词后,你可以再拿它去调用单词查询接口获取完整的词条详情。

返回内容涵盖

  • query:本次实际参与匹配的查询前缀。
  • count:返回的候选词数量。
  • suggestions:推荐列表数组。每项包含 word(候选词)和可选的 meaning(简短释义)。

使用须知

空结果处理 当输入的前缀没有匹配到任何单词时,接口会正常返回 HTTP 200,并且 suggestions 会是一个空数组 []。在前端对接时,直接将候选列表置空即可,无需将其当做异常错误来处理。

查询参数

q
string必填

要联想的英文前缀,长度不超过 64 个字符(也支持使用参数名 word)。

limit
integer可选

最多返回多少条候选词。默认 10,最大 30。

响应

200 / 请求成功

查询成功,返回单词推荐列表。如果没有匹配项,suggestions 将为空数组。

JSON

400 / 错误的请求

参数错误。例如 q 参数为空、长度超限,或 limit 不在合法范围内。

502 / 网关错误

服务暂时不可用,请稍后重试。

JSON