所有古诗词的api

时间：2023-03-09 22:59:43
所有古诗词的api
服务商:api.getlove.cn 分类:诗词 更新时间:2016-03
如果接口不满足您的要求，您可以联系qq:2265658022购买完整的数据库
免费apikey:56eab527a0facb6670b552fd
简介:根据诗人姓名(词人姓名)或者诗词标题查找到对应的诗词的详细类容

诗词查询API调用方法

接口地址:http://api.getlove.cn/api/poetry

请求方法:POST

请求次数:每天可免费请求100000次

请求参数(header):

参数名 类型 必填 参数位置 描述 默认值
apikey string 是 header API密钥 56eab527a0facb6670b552fd(每天可免费请求100000次)

请求参数(bodyParam):

参数名 类型 必填 参数位置 描述 示例
title string 否 bodyParam 诗词标题 绝句
author string 否 bodyParam 诗人或者词人 李白
year string 否 bodyParam 年代 唐朝
start number 否 bodyParam 查询起点 0
limit number 否 bodyParam 查询条数,数值范围[1-8] 5

请求参数说明

appkey:56eab421a0facb6670b552f5。
title与author这两个参数不得都为空
year:传入年代，可以更精确定位诗词(同名诗有很多)。分别是 先秦 汉朝 魏晋 南北朝 隋朝 唐朝 宋朝 金朝 辽朝 元朝 明朝 清朝 近当代
start:默认为0，你可以根据第一次查询返回的总数进行调整
limit:默认为5，你可以传[1-8]的整数

请求实例(nodejs):

var request=require("superagent");
request
    .post("http://api.getlove.cn/api/poetry")
    .set("apikey","56eab527a0facb6670b552fd")
    .send({title:"绝句",start:5})            //title与author必须要写一个
    .end(function(err,res){
        console.log(res.body);
    });

请求实例 (ajax)

        $.ajax({
            url:"http://api.getlove.cn/api/poetry",
            type:"post",
            data:{author:"李白",start:5},
            headers:{
                "apikey":"56eab527a0facb6670b552fd"
            },
            success:function(data){
                alert(JSON.stringify(data));
            }
        });

JSON返回示例:

{ status: '0',  //状态，成功为0，不成功返回错误码
  msg: 'ok',    //返回错误消息
  count: 149,   //返回诗词总数，可以根据这个制定分页查询
  result:
  [ { _id: '56daa047277b5a7c0cb2c074',
    title: '绝句',                                                    //标题
    years: '唐朝',                                                    //年代
    author: '童翰卿',                                                 //作者
    infoText: '大朴逐物尽，哀我天地功。争得荣辱心，洒然归西风。' },   //诗词内容
    { _id: '56daa053277b5a7c0cb2c132',
      title: '绝句',
      years: '唐朝',
      author: '吴公',
      infoText: '去国投兹土，编茅隐旧踪。年年秋水上，独对数株松。' },
    { _id: '56daa18c277b5a7c0cb2d266',
      title: '绝句',
      years: '宋朝',
      author: '杨万里',
      infoText: '枫老颜方少，山晴气及昏。旧贫今更甚，已冷幸犹暄。' },
    { _id: '56daa2aa277b5a7c0cb2e1dd',
      title: '绝句',
      years: '宋朝',
      author: '苏轼',
      infoText: '柴桑春晚思依依，屋角鸣鸠雨欲飞。昨日已收寒食火，吹花风起却添衣。' },
    { _id: '56daa2aa277b5a7c0cb2e1de',
      title: '绝句',
      years: '宋朝',
      author: '苏轼',
      infoText: '春来濯濯江边柳，秋後离离湖上花。不羡千金买歌舞，一篇珠玉是生涯。' }
  ]
}

相关文章