跳到主要内容
版本:v2

查询字词的内容数据

接口地址:/content

请求方式:GET

响应数据类型:application/json

接口描述:

  1. 接口返回的部分内容是乱码需要下载对应的字体包才能显示
  2. 获取字体令牌和字体名字默认是在响应头中,需要传入在请求的参数加上 fontIn=body 才会在响应体中,加了这个参数会导致返回的json会变为以下内容
      {
    "data": {
    // 源数据
    },
    "font": {
    "id":"字体的ID,通过这个ID可以直接下载字体包",
    "name":"字体的名字",
    "token":"字体的令牌",
    }
    }
  3. 如果没有返回field字段的话json对象是直接没有这个key而不是会返回null
  4. 默认使用错词纠错,如果不需要使用纠错请传入 useCorrect=false
  5. 如果纠错成功会返回 correctWord 字段,如果没有纠错则不会返回
  6. 如果不传 fields 默认只查询释文和基本信息,但是如果没有释文则会从其它索引中获取
  7. 如果不想只加载释文信息需要查询所有功能数据,请直接指定 fields,但是这样可能会影响接口的性能,因为如果传入所有的会导致接口变慢
  8. 接口有限流所以不能调用太快

请求参数:

参数名称参数说明请求类型是否必须数据类型schema
q要查询的文字querytruestring
Authorization授权请求头headertruestring
fields要查询的功能,逗号分隔 eg: shiwen.danzi,shiwen.baike,shiciqueryfalsearraystring
useCorrect是否使用自动纠错,true使用,false不使用queryfalseboolean
fontIn字体信息是否在响应体中queryfalse
x-jd-device设备信息headerfalsestring

响应状态:

状态码说明schema
200OKobject

响应参数:

参数名称参数说明类型schema
fields字段信息object
query搜索的原始文字string
correctWord纠错后的文字string
infoobject
  fields字段信息object
  danzi单字object
    radical部首string
    strokes笔画数integer(int32)
    strokeGifobject
      white标准笔顺gifstring
      black反色笔顺gifstring
    level字级string
    wordNum编码string
    spell拼音string
    chapterOrder笔顺string
    category分类string
    structure结构string
lazyFields懒加载字段array
shiwenobject
  danzi单字string
  yuci语词string
  baike百科string
  fields字段信息object
shufa书法object
yuanliu源流object
shici唐诗宋词arrayobject
  name诗词名string
  brandName词牌说明string
  wordOrder词序string
  content正文string
  annotation注释string
  appreciation赏析string
  appreciationAuthor赏析作者string
  bookName书籍名string
  author作者小传object
    name作者姓名string
    brief小传内容string
tongyici同义词array
jinyici近义词array
fanyici反义词array

响应示例:

{
"fields": {},
"query": "",
"correctWord": "",
"info": {
"fields": {},
"danzi": {
"radical": "",
"strokes": 0,
"strokeGif": {
"white": "",
"black": ""
},
"level": "",
"wordNum": "",
"spell": "",
"chapterOrder": "",
"category": "",
"structure": ""
}
},
"lazyFields": [],
"shiwen": {
"danzi": "",
"yuci": "",
"baike": "",
"fields": {}
},
"shufa": {},
"yuanliu": {},
"shici": [
{
"name": "",
"brandName": "",
"wordOrder": "",
"content": "",
"annotation": "",
"appreciation": "",
"appreciationAuthor": "",
"bookName": "",
"author": {
"name": "",
"brief": ""
}
}
],
"tongyici": [],
"jinyici": [],
"fanyici": []
}