<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$url = "https://api.jisuapi.com/tangshi/chapter?appkey=$appkey";
$result = curlOpen($url, ['ssl'=>true]);
$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
foreach($result as $val)
{
    echo $val['detailid'].' '.$val['name'].' '.$val['author'].'
';
}

import requests

appkey = 'your_appkey_here'
url = f"https://api.jisuapi.com/tangshi/chapter?appkey={appkey}"
response = requests.get(url)
response.raise_for_status()
jsonarr = response.json()

if jsonarr['status'] != 0:
    print(jsonarr['msg'])
else:
    result = jsonarr['result']
    for val in result:
        print(f"{val['detailid']} {val['name']} {val['author']}")

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": [
        {
            "detailid": "1",
            "name": "行宫",
            "author": "元稹"
        },
        {
            "detailid": "2",
            "name": "登鹳雀楼",
            "author": "王之涣"
        },
        {
            "detailid": "3",
            "name": "新嫁娘词",
            "author": "王建"
        },
        {
            "detailid": "4",
            "name": "相思",
            "author": "王维"
        },
        {
            "detailid": "5",
            "name": "杂诗·君自故乡来",
            "author": "王维"
        },
        {
            "detailid": "6",
            "name": "鹿柴",
            "author": "王维"
        },
        {
            "detailid": "7",
            "name": "竹里馆",
            "author": "王维"
        },
        {
            "detailid": "8",
            "name": "山中送别",
            "author": "王维"
        },
        {
            "detailid": "9",
            "name": "问刘十九",
            "author": "白居易"
        },
        {
            "detailid": "10",
            "name": "哥舒歌",
            "author": "西鄙人"
        },
        {
            "detailid": "11",
            "name": "静夜思",
            "author": "李白"
        },
        {
            "detailid": "12",
            "name": "怨情",
            "author": "李白"
        },
        {
            "detailid": "13",
            "name": "登乐游原",
            "author": "李商隐"
        },
        {
            "detailid": "14",
            "name": "听筝",
            "author": "李端"
        },
        {
            "detailid": "15",
            "name": "渡汉江",
            "author": "李频"
        },
        {
            "detailid": "16",
            "name": "八阵图",
            "author": "杜甫"
        },
        {
            "detailid": "17",
            "name": "宿建德江",
            "author": "孟浩然"
        },
        {
            "detailid": "18",
            "name": "春晓",
            "author": "孟浩然"
        },
        {
            "detailid": "19",
            "name": "春怨",
            "author": "金昌绪"
        },
        {
            "detailid": "20",
            "name": "江雪",
            "author": "柳宗元"
        },
        {
            "detailid": "21",
            "name": "秋夜寄邱员外",
            "author": "韦应物"
        },
        {
            "detailid": "22",
            "name": "终南望余雪",
            "author": "祖咏"
        },
        {
            "detailid": "23",
            "name": "宫词·故国三千里",
            "author": "张祜"
        },
        {
            "detailid": "24",
            "name": "寻隐者不遇",
            "author": "贾岛"
        },
        {
            "detailid": "25",
            "name": "送崔九",
            "author": "裴迪"
        },
        {
            "detailid": "26",
            "name": "送灵澈",
            "author": "刘长卿"
        },
        {
            "detailid": "27",
            "name": "听弹琴",
            "author": "刘长卿"
        },
        {
            "detailid": "28",
            "name": "送上人",
            "author": "刘长卿"
        },
        {
            "detailid": "29",
            "name": "玉台体",
            "author": "权德舆"
        },
        {
            "detailid": "30",
            "name": "芙蓉楼送辛渐",
            "author": "王昌龄"
        },
        {
            "detailid": "31",
            "name": "闺怨",
            "author": "王昌龄"
        },
        {
            "detailid": "32",
            "name": "春宫曲",
            "author": "王昌龄"
        },
        {
            "detailid": "33",
            "name": "九月九日忆山东兄弟",
            "author": "王维"
        },
        {
            "detailid": "34",
            "name": "凉州词",
            "author": "王翰"
        }
    ]
}

接口地址： https://api.jisuapi.com/tangshi/detail

返回格式： JSON

请求方法： GET POST

请求示例： https://api.jisuapi.com/tangshi/detail?appkey=yourappkey&detailid=1

请求参数：

在线测试

参数名称	类型	必填	说明
detailid	int	是	详情ID

返回参数：

参数名称	类型	说明
title	string	名称
content	string	内容
explanation	string	解释
type	string	类型
appreciation	string	赏析
author	string	作者
detailid	int	详情ID

请求代码：

查看代码

PHP
Python

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$detailid = 1;
$url = "https://api.jisuapi.com/tangshi/detail?appkey=$appkey&detailid=$detailid";
$result = curlOpen($url, ['ssl'=>true]);
$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['detailid'].' '.$result['title'].' '.$result['type'].' '.$result['author'].'
';
echo $result['content'].' '.$result['explanation'].' '.$result['appreciation'].'
';

import requests

appkey = 'your_appkey_here'
detailid = 1
url = f"https://api.jisuapi.com/tangshi/detail?appkey={appkey}&detailid={detailid}"

response = requests.get(url)
jsonarr = response.json()
if jsonarr['status'] != 0:
    print(jsonarr['msg'])
else:
    result = jsonarr['result']
    print(f"{result['detailid']} {result['title']} {result['type']} {result['author']}")
    print(f"{result['content']} {result['explanation']} {result['appreciation']}")

JSON返回示例 :

{ "status": 0, "msg": "ok", "result": { "detailid": "1", "title": "行宫", "type": "五言绝句", "content": "

寥落古行宫，宫花寂寞红。
白头宫女在，闲坐说玄宗。

", "explanation": "

　　⑴寥落：寂寞冷落。

　　⑵行宫：皇帝在京城之外的宫殿。

", "appreciation": "

　　元稹的这首《行宫》是一首抒发盛衰之感的诗，可与白居易《上阳白发人》参互并观。这里的古行宫即洛阳行宫上阳宫，白头宫女即“上阳白发人”。据白居易《上阳白发人》，这些宫女天宝（742-756）末年被“潜配”到上阳宫，在这冷宫里一闭四十多年，成了白发宫人。这首短小精悍的五绝具有深邃的意境，富有隽永的诗味，倾诉了宫女无穷的哀怨之情，寄托了诗人深沉的盛衰之感。

　　此诗首句点明地点：古行宫；二句暗示时间：红花盛开之季；三句介绍人物；白头宫女；四句描绘动作：闲坐说玄宗。构筑了一幅完整动人的图画。当年花容月貌，娇姿艳质，辗转落入宫中，寂寞幽怨；此时青春消逝，红颜憔悴；闲坐无聊，只有谈论已往。此情此景，十分凄绝。这首诗平实，但很有概括力，也很含蓄，并给人以想象的天地，历史沧桑之感尽在不言之中。

　　诗人塑造意境，艺术上主要运用了两种表现手法。一是以少总多。我国古典诗歌讲究精炼，写景、言情、叙事都要以少总多。这首诗正具有举一而反三，字少而意多的特点。四句诗，首句指明地点，是一座空虚冷落的古行宫；次句暗示环境和时间，宫中红花盛开，正当春天季节；三句交代人物，几个白头宫女，与末句联系起来推想，可知是玄宗天宝末年进宫而幸存下来的老宫人；末句描写动作，宫女们正闲坐回忆、谈论天宝遗事。二十个字，地点、时间、人物、动作，全都表现出来了，构成了一幅非常生动的画面。这个画面触发读者联翩的浮想：宫女们年轻时都是月貌花容，娇姿艳质，这些美丽的宫女被禁闭在这冷落的古行宫之中，成日价寂寞无聊，看着宫花，花开花落，年复一年，青春消逝，红颜憔悴，白发频添，如此被摧残，往事不堪重省。然而，她们被禁闭冷宫，与世隔绝，别无话题，却只能回顾天宝时代玄宗遗事，此景此情，令人凄绝。“寥落”、“寂寞”、“闲坐”，既描绘当时的情景，也反映诗人的倾向。凄凉的身世，哀怨的情怀，盛衰的感慨，二十个字描绘出那样生动的画面，表现出那样深刻的意思，所以宋洪迈《容斋随笔》卷二说这首诗“语少意足，有无穷之味”；明胡应麟《诗薮·内编》卷六以为这首诗是王建所作，并说“语意绝妙，合（王）建七言《宫词》百首，不易此二十字也”。

　　另一个表现手法是以乐景写哀。我国古典诗歌，其所写景物，有时从对立面的角度反衬心理，利用忧思愁苦的心情同良辰美景气氛之间的矛盾，以乐景写哀情，却能收到很好的艺术效果。这首诗也运用了这一手法。诗所要表现的是凄凉哀怨的心境，但却着意描绘红艳的宫花。红花一般是表现热闹场面，烘托欢乐情绪的，但在这里却起了很重要的反衬作用：盛开的红花和寥落的行宫相映衬，加强了时移世迁的盛衰之感；春天的红花和宫女的白发相映衬，表现了红颜易老的人生感慨；红花美景与凄寂心境相映衬，突出了宫女被禁闭的哀怨情绪。红花，在这里起了很大的作用。这都是利用好景致与恶心情的矛盾，来突出中心思想，即王夫之《姜斋诗话》所谓“以乐景写哀”，一倍增其哀。白居易《上阳白发人》“宫莺百啭愁厌闻，梁燕双栖老休妒”，也可以说是以乐写哀。不过白居易的写法直接揭示了乐景写哀情的矛盾，而元稹《行宫》则是以乐景作比较含蓄的反衬，显得更有余味。

", "author": "元稹" } }

接口地址： https://api.jisuapi.com/tangshi/search

返回格式： JSON

请求方法： GET POST

请求示例： https://api.jisuapi.com/tangshi/search?appkey=yourappkey&keyword=白日

请求参数：

在线测试

参数名称	类型	必填	说明
keyword	string	是	关键词
pagesize	int	是	每页数量默认1 最大4
pagenum	int	是	页码默认1

返回参数：

参数名称	类型	说明
total	string	总数
pagenum	int	当前页
pagesize	int	每页数量
title	string	标题
type	string	分类
content	string	内容
explanation	string	解释
appreciation	string	赏析
author	string	作者

请求代码：

查看代码

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$keyword = '白日';//utf8
$pagesize = 1;
$pagenum = 1;
$url = "https://api.jisuapi.com/tangshi/search?appkey=$appkey&keyword=$keyword&pagesize=$pagesize&pagenum=$pagenum";
$result = curlOpen($url, ['ssl'=>true]);
$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['total'].' '.$result['pagesize'].' '.$result['pagenum'].'
';
foreach($result['list'] as $val)
{
    echo $val['total'].' '.$val['pagenum'].' '.$val['pagesize'].' '.$val['title'].' '.$val['type'].' '.$val['content'].' '.$val['explanation'].' '.$val['appreciation'].' '.$val['author'].'
';
}

#!/usr/bin/python
# encoding:utf-8

import requests

# 1、唐诗查询

data = {}
data["appkey"] = "your_appkey_here"
data["keyword"] = "白日"
data["pagesize"] = 1
data["pagenum"] = 1
url = "https://api.jisuapi.com/tangshi/search"
response = requests.get(url,params=data)
jsonarr = response.json()
if jsonarr["status"] != 0:
    print(jsonarr["msg"])
    exit()
result = jsonarr["result"]
print(result["total"],result["pagesize"],result["pagenum"])
for val in result["list"]:
    print(val["title"],val["type"],val["content"],val["explanation"],val["appreciation"],val["author"])

package api.jisuapi.tangshi;

import java.net.URLEncoder;

import api.util.HttpUtil;
import net.sf.json.JSONArray;
import net.sf.json.JSONObject;

public class Search {

	public static final String APPKEY = "your_appkey_here";// 你的appkey
	public static final String URL = "https://api.jisuapi.com/tangshi/search";
	public static final String keyword = "白日";// utf-8

	public static void Get() throws Exception {
		String result = null;
		String url = URL + "?appkey=" + APPKEY + "&keyword=" + URLEncoder.encode(keyword, "utf-8");

		try {
			result = HttpUtil.sendGet(url, "utf-8");
			JSONObject json = JSONObject.fromObject(result);
			if (json.getInt("status") != 0) {
				System.out.println(json.getString("msg"));
			} else {
				JSONObject resultarr = json.optJSONObject("result");
				String total = resultarr.getString("total");
				String pagenum = resultarr.getString("pagenum");
				String pagesize = resultarr.getString("pagesize");
				System.out.println(total + " " + pagenum + " " + pagesize);
				JSONArray list = resultarr.optJSONArray("list");
				for (int i = 0; i < list.size(); i++) {
					JSONObject obj = list.optJSONObject(i);
					String title = obj.getString("title");
					String type = obj.getString("type");
					String content = obj.getString("content");
					String explanation = obj.getString("explanation");
					String appreciation = obj.getString("appreciation");
					String author = obj.getString("author");
					System.out.println(
							title + " " + type + " " + content + " " + explanation + " " + appreciation + " " + author);
				}
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

JSON返回示例 :

{ "status": 0, "msg": "ok", "result": { "total": "9", "pagenum": "1", "pagesize": "1", "list": [ { "title": "登鹳雀楼", "type": "五言绝句", "content": "白日依山尽，黄河入海流。
欲穷千里目，更上一层楼。", "explanation": "

　　1．鹳雀楼：旧址在山西永济县，楼高三层，前对中条山，下临黄河。传说常有鹳雀在此停留，故有此名。

", "appreciation": "

　　这首诗写诗人在登高望远中表现出来的不凡的胸襟抱负，反映了盛唐时期人们积极向上的进取精神。

", "author": "王之涣" } ] } }

API错误码：

代号	说明
201	关键词为空
203	没有信息

系统错误码：

代号	说明
101	APPKEY为空或不存在
102	APPKEY已过期
103	APPKEY无请求此数据权限
104	请求超过次数限制
105	IP被禁止
106	IP请求超过限制
107	接口维护中
108	接口已停用