如何获取指定诗歌ID的《唐诗三百首》接口

发布时间 2023-12-02 16:44:01作者: Api接口开发者

随着移动互联网的普及,越来越多的人开始学习和欣赏唐诗。不过,对于一些想要获取指定诗歌ID的人来说,这似乎是一件有点困难的事情。好在《唐诗三百首》接口为我们提供了方便快捷的解决方法。下面,就让我们来介绍一下如何获取指定诗歌ID的《唐诗三百首》接口。

数据源介绍: 数据示例下载 ↓

《唐诗三百首》共选入唐代诗人77位,计311首诗,其中五言古诗33首,乐府46首,七言古诗28首,七言律诗50首,五言绝句29首,七言绝句51首,诸诗配有注释和评点。 五言古诗简称五古,是唐代诗坛较为流行的体裁。唐人五古笔力豪纵,气象万千,直接用于叙事、抒情、议论、写景,使其功能得到了空前的发挥,其代表作家李白、杜甫、王维、孟浩然、韦应物等。 七言古诗简称七古,起源于战国时期,甚至更早。

 

一. 接口的调用方式

1.1 获取诗歌列表

首先,我们需要获取到《唐诗三百首》的诗歌列表,这可以通过以下代码实现:

 

curl --request GET \
--url 'https://www.wapi.cn/source/10.html/tang_poetry?type=1&page=1&count=1000' \
--header 'accept: application/json'

  

其中,type参数为1,代表获取全部诗歌;page和count参数可以根据需要进行修改。

1.2 搜索指定诗歌

有了诗歌列表,我们就可以根据自己的需求搜索指定的诗歌了,以下是实现代码:

 

curl --request GET \
--url 'https://www.wapi.cn/source/10.html=王之涣' \
--header 'accept: application/json'

 

其中,type参数为2,代表搜索;title和author参数则是我们要搜索的诗歌名称和作者。

1.3 获取指定诗歌ID

最后,我们需要从搜索结果中获取到我们需要的诗歌ID,这可以通过以下代码实现:

curl --request GET \
--url 'https://www.wapi.cn/source/10.html=300' \
--header 'accept: application/json'

 

其中,type参数为3,代表获取指定诗歌;id参数则是我们要获取的诗歌ID。

二. 示例代码

下面是一个示例代码,它可以根据用户输入的诗歌名称和作者来获取指定诗歌的ID:

 

python
import requests

def get_poetry_id(title, author):
url = 'https://www.wapi.cn/source/10.html=2&title={}&author={}'.format(title, author)
r = requests.get(url)
result = r.json()['result'][0]
poetry_id = result['id']
return poetry_id

# 以下是测试代码
title = input('请输入诗歌名称:')
author = input('请输入作者名称:')
poetry_id = get_poetry_id(title, author)
print('《{}》的ID为{}'.format(title, poetry_id))

 

三. 总结

通过调用《唐诗三百首》接口,我们可以方便地获取到指定诗歌的ID。这为我们更方便地学习和欣赏唐诗提供了便利。希望本文能够对大家有所帮助。最后,附上一首唐诗以献给读者:

《登高》

临晚居高远,空余百虑生。

江山故垒在,何处是温泉?

草色新雨中,松声晚窗里。

欲寻芳草去,惜与故人违。