跳到主要内容
版本:v2

查询字词的书籍的释文数据

接口地址:/book/explain

请求方式:GET

响应数据类型:application/json

接口描述:

  1. 精确匹配查的字词,支持多本书的书籍ID传入,如果不传书籍ID会查询该客户端所有的书籍释文
  2. 接口返回的部分内容是乱码需要下载对应的字体包才能显示
  3. 获取字体令牌和字体名字默认是在响应头中需要传入 fontIn=body 才会在响应体中,并且返回json会变为一下内容
      {
    "data": {
    // 源数据
    },
    "font": {
    "id":"字体的ID,通过这个ID可以直接下载字体包",
    "name":"字体的名字",
    "token":"字体的令牌",
    }
    }
  4. 接口有限流所以不能调用太快

请求参数:

参数名称参数说明请求类型是否必须数据类型schema
Authorization授权请求头headertruestring
x-jd-device设备信息headerfalsestring
q要搜索的字/词querytruestring
simplified是否同时搜索简体, false 不搜索,true搜索queryfalseboolean
qualitative是否同时定性语, false 不搜索,true搜索queryfalseboolean
maxSize结果的最大大小,最多支持100条数据queryfalseinteger(int32)
bookId需要搜索的书籍,为空搜索全部有权限的书籍queryfalsearrayinteger
synonym是否同时包含近义词搜索 false 不搜索,true 搜索queryfalseboolean

响应状态:

状态码说明schema
200OKobject

响应参数:

参数名称参数说明类型schema
entries释文列表arrayobject
  idinteger(int64)
  headword词头string
  xml释文xmlstring
  bookName书籍名字string
  simplified简体string
qualitatives定性语列表arrayQualitative
  headword词头string
  name定性语名字string
  qualitative定性语integer(int32)
  entryType词头类型,可用值:WORDS,ENCYCLOPEDIA,EPOCH,PLACE_NAME,ENGLISH,Synonym,CHINESE_ENGLISHstring
  spell拼音string

响应示例:

{
"entries": [
{
"id": 0,
"headword": "",
"xml": "",
"bookName": "",
"simplified": ""
}
],
"qualitatives": [
{
"headword": "",
"name": "",
"qualitative": 0,
"entryType": "",
"spell": ""
}
]
}