诗词接口,诗词API
说明
提供中国诗词相关接口,如诗词搜索,诗词详情,作者搜索,作者详情等。
如果现在所提供的接口不能满足你的要求,可以通过http://blog.getlove.cn/article/5b289d7980ca8b10b8a173a3联系我进行接口定制或者数据库的购买。
数据准确性可以通过关注微信公众号 灵犀汉语字词典进行体验
公共请求参数及接口签名:http://blog.getlove.cn/article/5c88d875641ec410596f3969
服务器地址
https://account.getlove.cn/apiGetWay/5b010c7445657b2b64ada7a2
示例代码(nodejs)
https://github.com/liuyinglong/api_get_way_demo/blob/master/example/poetry.js
一、根据关键词搜索内容
1、请求路径(请再路径前拼接服务器地址)
/api/v1/poetry/search
2、请求参数
- query
参数 | 类型 | 必传 | 默认值 | 说明 |
---|---|---|---|---|
keywords | String | 是 | 搜索的关键词 | |
type | String | 否 | type当前支持的类型为title , author ,text 。不传入此参数则查询所有类型的数据(建议在第一页使用) |
|
page | Number | 否 | 1 | 页码,从第一页开始 |
size | Number | 否 | 1 | 每一页的查询的总次数(当前最大值为15,超过15则按照15来计算) |
3、返回示例
-
请求:
/api/v1/poetry/search?keywords=此时此夜难为情&type=text
{ "code": 1000, "message": "success", "resp": { "page": 1, "data": [ { "_id": "59dcbea5ee1d825331ff34f6", "title": "秋风清", "author": { "_id": "59dca987bddaf83748e8904c", "dynastyText": "唐朝", "name": "李白" }, "straightMatter": "秋风清,秋月明。落叶聚还散,寒鸦栖复惊。相思相见知何日,此时此夜难为情。", "tag": [] } ], "count": 1 } }
-
请求:
/api/v1/poetry/search?keywords=李白&size=1
{
"code": 1000,
"message": "success",
"resp": {
"titleList": {
"page": 1,
"data": [
{
"_id": "59dcc9c4ee1d82533101b19f",
"title": "李白",
"author": {
"_id": "59dca9a2bddaf83748e89a44",
"dynastyText": "宋朝",
"name": "徐钧"
},
"straightMatter": "风骨神仙籍里人,诗狂酒圣且平生。开元一遇成何事,留得千秋万古名。",
"tag": []
}
],
"count": 1
},
"authorList": {
"page": 1,
"data": [
{
"_id": "59dcbea3ee1d825331ff341a",
"title": "秋日鲁郡尧祠亭上宴别杜补阙范侍御",
"author": {
"_id": "59dca987bddaf83748e8904c",
"dynastyText": "唐朝",
"name": "李白"
},
"straightMatter": "我觉秋兴逸,谁云秋兴悲。山将落日去,水与晴空宜。鲁酒白玉壶,送行驻金羁。歇鞍憩古木,解带挂横枝。歌鼓川上亭,曲度神飙吹。云归碧海夕,雁没青天时。相失各万里,茫然空尔思。",
"tag": []
}
],
"count": 981
},
"textList": {
"page": 1,
"data": [
{
"_id": "59dcbe82ee1d825331ff237c",
"title": "还人卷",
"author": {
"_id": "59dca987bddaf83748e8904d",
"dynastyText": "唐朝",
"name": "齐己"
},
"straightMatter": "李白李贺遗机杼,散在人间不知处。闻君收在芙蓉江,日斗鲛人织秋浦。金忆札札文离离。吴姬越女羞上机。鸳鸯浴烟鸾凤飞,澄江晓映馀霞辉。仙人手持玉刀尺,寸寸酬君珠与璧。裁作霞裳何处披,紫皇殿里深难觅。",
"tag": []
}
],
"count": 304
}
}
}
二、 获取诗词详情
1、请求路径(请再路径前拼接服务器地址)
/api/v1/poetry/detail/:poetryId
2、请求参数
- params
参数 | 类型 | 必传 | 默认值 | 说明 |
---|---|---|---|---|
poetryId | String | 是 | 无 | 诗词的ID |
3、请求示例
- 请求
/api/v1/poetry/detail/59dcbea4ee1d825331ff3432
{
"code": 1000,
"message": "success",
"resp": {
"_id": "59dcbea4ee1d825331ff3432",
"title": "上之回",
"author": {
"_id": "59dca987bddaf83748e8904c",
"dynastyText": "唐朝",
"name": "李白",
"resume": "\n 李白(701年2月28日—762),字太白,号青莲居士。中国唐朝诗人,有“诗仙”之称,是伟大的浪漫主义诗人。汉族,祖籍陇西郡成纪县(今甘肃省平凉市静宁县南),出生于蜀郡绵州昌隆县(今四川省江油市青莲乡),一说生于西域碎叶(今吉尔吉斯斯坦托克马克)。逝世于安徽当涂县。其父李客,夫人有许氏、刘氏等四位,育二子(伯禽、天然)一女(平阳)。存世诗文千余篇,代表作有《蜀道难》、《行路难》、《梦游天姥吟留别》、《将进酒》等诗篇,有《李太白集》传世。公元762年病卒,享年61岁。其墓在安徽当涂,四川江油、湖北安陆有纪念馆。 "
},
"straightMatter": "三十六离宫,楼台与天通。阁道步行月,美人愁烟空。\n\n恩疏宠不及,桃李伤春风。淫乐意何极,金舆向回中。\n\n万乘出黄道,千旗扬彩虹。前军细柳北,后骑甘泉东。\n\n岂问渭川老,宁邀襄野童。秋暮瑶池宴,归来乐未穷。\n\n\n ",
"appreciation": "",
"tag": [
{
"name": "忧国忧民",
"_id": "59dd970953d50f16da6816cb"
}
]
}
}
三、获取作者详情
1、请求路径(请再路径前拼接服务器地址)
/api/v1/author/detail/:authorId
2、请求参数
- params
参数 | 类型 | 必传 | 默认值 | 说明 |
---|---|---|---|---|
authorId | String | 是 | 无 | 作者的ID |
3、返回示例
- 请求
/api/v1/author/detail/59dca987bddaf83748e8904c
{
"code": 1000,
"message": "success",
"resp": {
"_id": "59dca987bddaf83748e8904c",
"dynastyText": "唐朝",
"name": "李白",
"resume": "\n 李白(701年2月28日—762),字太白,号青莲居士。中国唐朝诗人,有“诗仙”之称,是伟大的浪漫主义诗人。汉族,祖籍陇西郡成纪县(今甘肃省平凉市静宁县南),出生于蜀郡绵州昌隆县(今四川省江油市青莲乡),一说生于西域碎叶(今吉尔吉斯斯坦托克马克)。逝世于安徽当涂县。其父李客,夫人有许氏、刘氏等四位,育二子(伯禽、天然)一女(平阳)。存世诗文千余篇,代表作有《蜀道难》、《行路难》、《梦游天姥吟留别》、《将进酒》等诗篇,有《李太白集》传世。公元762年病卒,享年61岁。其墓在安徽当涂,四川江油、湖北安陆有纪念馆。 "
}
}
四、获取作者相关诗词
1、请求路径(请再路径前拼接服务器地址)
/api/v1/author/poetryList/:authorId
2、请求参数
- params
参数 | 类型 | 必传 | 默认值 | 说明 |
---|---|---|---|---|
authorId | String | 是 | 无 | 作者的ID |
- query
参数 | 类型 | 必传 | 默认值 | 说明 |
---|---|---|---|---|
page | Number | 否 | 1 | 页码,从第一页开始 |
size | Number | 否 | 15 | 每一页的查询的总次数(当前最大值为15,超过15则按照15来计算) |
3、返回示例
- 请求
/api/v1/author/detail/59dca987bddaf83748e8904c?size=2
{
"code": 1000,
"message": "success",
"resp": {
"data": [
{
"_id": "59dcbea3ee1d825331ff341a",
"title": "秋日鲁郡尧祠亭上宴别杜补阙范侍御",
"author": {
"_id": "59dca987bddaf83748e8904c",
"dynastyText": "唐朝",
"name": "李白"
},
"straightMatter": "我觉秋兴逸,谁云秋兴悲。山将落日去,水与晴空宜。鲁酒白玉壶,送行驻金羁。歇鞍憩古木,解带挂横枝。歌鼓川上亭,曲度神飙吹。云归碧海夕,雁没青天时。相失各万里,茫然空尔思。",
"tag": []
},
{
"_id": "59dcbea3ee1d825331ff3421",
"title": "冬夜醉宿龙门觉起言志",
"author": {
"_id": "59dca987bddaf83748e8904c",
"dynastyText": "唐朝",
"name": "李白"
},
"straightMatter": "醉来脱宝剑,旅憩高堂眠。中夜忽惊觉,起立明灯前。开轩聊直望,晓雪河冰壮。哀哀歌苦寒,郁郁独惆怅。傅说版筑臣,李斯鹰犬人。欻起匡社稷,宁复长艰辛。而我胡为者,叹息龙门下。富贵未可期,殷忧向谁写。去去泪满襟,举声梁甫吟。青云当自致,何必求知音。",
"tag": []
}
],
"count": 981,
"pageNo": 1,
"pageSize": 2
}
}