当前位置：首页 > article >正文

如何获取唐诗三百首中的名句列表接口

article 2024/9/25 1:20:10

唐诗三百首，是中国文学中最为经典的诗歌选集之一，其中涵盖了大量美丽、深刻的诗句，被广泛传诵。有不少文化爱好者希望能够获取这些名句列表，以便深入理解唐诗的内涵和精华。那么，如何获取唐诗三百首中的名句列表呢？这就需要用到相关的API接口了。下面就介绍一下如何使用《如何获取唐诗三百首中的名句列表接口》。

数据源介绍：

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

接口说明

该接口是通过访问挖数据平台来获取唐诗三百首中的名句列表。该接口可以帮助用户搜索到唐诗三百首中的相关诗句，并获取相关的基本信息，包括作者、题目、诗句内容等等。

参数说明

该接口需要的参数如下：

参数名	类型	说明
keyword	string	搜索关键词，可以是唐诗三百首中的任一诗句、作者或题目等等
page	int	分页参数，指定返回结果的页数
per_page	int	分页参数，指定每页返回结果的数量

返回结果

该接口返回的JSON数据格式如下：

{
    "status": "success",
    "total": 1000,
    "data": [
        {
            "author": "王之涣",
            "title": "登鹳雀楼",
            "content": "白日依山尽，黄河入海流。",
            "url": "https://www.gushiwen.org/shiwenv_2ee2b807f52c.aspx"
        },
        {
            "author": "李白",
            "title": "将进酒",
            "content": "人生得意须尽欢，莫使金樽空对月。",
            "url": "https://www.gushiwen.org/shiwenv_60ae6c834306.aspx"
        },
        {
            "author": "李白",
            "title": "庐山谣",
            "content": "问君能有几多愁？恰似一江春水向东流。",
            "url": "https://www.gushiwen.org/shiwenv_4c84a42b7d43.aspx"
        }
    ],
    "page": 1,
    "per_page": 10
}

其中，status表示请求状态，total表示搜索结果总数，data表示搜索结果列表，page表示当前页码，per_page表示当前页返回结果数量。

调用样例

我们可以使用Requests库来调用该接口，并获取响应结果。样例代码如下：

import requests

url = "https://api.wapi.cn/songci"
params = {
    "keyword": "白日依山尽",
    "page": 1,
    "per_page": 10
}

response = requests.get(url, params=params)
result = response.json()

print(result)

上述代码中，我们指定了搜索关键词为“白日依山尽”，并分页获取第一页的10条结果。运行后，就可以得到相应的JSON格式的响应结果。