诏预

古代诗词歌赋文章中的名言名句

接口文档与相关说明

以下内容是简略文档,详细文档请访问:https://docs.saintic.com/open/sentence.html
关于数据来源
  • * 接口数据来源于古诗文网和诗词公开数据库(大约12k条数据),包括诗、词、歌、赋、古籍等。
  • * 源于公开数据库的部分(大约4k条)未查到主题、分类及来源URL。
关于接口返回
  • * 请参阅RULE规则,共三个点,每个点表示含义不同,最后一个点后是后缀,即.suffix
  • * suffix支持json、txt、svg格式,其中svg参考了古诗词·一言API,暂不支持png,默认是json!
  • * json返回字段code为0表示请求成功,data是名句数据,q是RULE解析后的数据;若code不为0,msg为异常消息。
关于规则与查询参数
  • * 接口地址:http://open.saintic.com/api/sentence/RULE
  • * RULE规则
    • #: 注意:all.表示随机
    • 1. 为空时: 格式默认,随机返回名句
    • 2. 不为空但没有点: catalog_pinyin: 随机返回分类中名句,格式默认
    • 3. 一个点: catalog_pinyin.suffix:
      • - 点后为后缀,支持svg,json,txt;
      • - 点前为catalog之分类,默认all,随机返回名句
    • 4. 两个点: theme_pinyin.catalog_pinyin.suffix:
      • - 第一个点前是主题,留空或all即随机
      • - 第二个点前是分类,留空或all即随机
      • - 第二个点后是后缀
    • 5. 三个点: author_pinyin.theme_pinyin.catalog_pinyin.suffix:
      • - 第一个点前是作者,留空或all即随机
      • - 第二个点前是主题,留空或all即随机
      • - 第三个点前是分类,留空或all即随机
      • - 第三个点后是后缀
  • * 个性化查询参数(针对.svg后缀):
    参数 说明 默认 备注
    has-url 是否显示名句原文 可选true、on、1等开启此选项,但仍需要存在原文链接才能点击
    letter-spacing 字体间隔(px) 1.5 合法范围[0-30]
    text-decoration 文本修饰 可选none、underline、overline等
    fill 文本颜色 比如red、#f00
    fill-opacity 外观透明度 合法范围[0-1]
    font-family 字体系列 建议使用字体英文名称,比如Kaiti
    font-weight 字体粗细 可选normal、bold、数值等
    font-size 字体大小(px) 20 合法范围[8,50]
    inline-style 是否内联样式 可选true、on、1等开启此选项,表示仅返回svg纯文本内容!
  • * RULE示例:
  • * 使用方法:
    • * 对于svg,可以使用<img src="">引用,img中可以写行内样式。
    • * 对于txt、json等格式,可以通过ajax调用。
公开的主题及子分类(可点击查看对应接口)