<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$url = "https://api.jisuapi.com/songci/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'].'
';
}

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": "李珣"
        }
    ]
}

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

返回格式： JSON

请求方法： GET POST

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

请求参数：

在线测试

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

返回参数：

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

请求代码：

查看代码

PHP

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$detailid = 1;
$url = "https://api.jisuapi.com/songci/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'].'
';

JSON返回示例 :

{ "status": 0, "msg": "ok", "result": { "detailid": "1", "title": "菩萨蛮·平林漠漠烟如织", "type": "卷一·唐五代词", "content": "

　　平林漠漠烟如织，寒山一带伤心碧。暝色入高楼，有人楼上愁。玉阶空伫立，宿鸟归飞急。何处是归程？长亭更短亭。

", "explanation": "

　　①平林：平展的树林。
　　②漠漠；迷蒙貌。
　　③伤心碧：使人伤心的碧绿色。一说“伤心”表示程度，与“极”同义。
　　④暝色：夜色。
　　⑤玉阶：阶之美称。一作“玉梯”。
　　⑥伫立：久立。
　　⑦归程：归途。
　　⑧长亭更短亭：古代设在路边供行人休歇的亭舍。庾信《哀江南赋》云：“十里五里，长亭短亭。”说明当时每隔十里设一长亭，五里设一短亭。“更”，一作“连”。亭，《释名》卷五：亭，停也，人所停集也。

", "appreciation": "", "author": "李白" } }

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

返回格式： JSON

请求方法： GET POST

请求示例： https://api.jisuapi.com/songci/search?appkey=yourappkey&keyword=扬州慢

请求参数：

在线测试

参数名称	类型	必填	说明
keyword	string	是	关键词
pagesize	string	是	每页数量默认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/songci/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/songci/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.songci;

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/songci/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": "1", "pagenum": "1", "pagesize": "1", "list": [ { "title": "扬州慢·淮左名都", "type": "卷九·南宋词", "content": "淳熙丙申至日⑵，予过维扬⑶。夜雪初霁，荠麦弥望⑷。入其城，则四顾萧条，寒水自碧，暮色渐起，戍角悲吟⑸。予怀怆然，感慨今昔，因自度此曲。千岩老人以为有“黍离”之悲也⑹。
淮左名都⑺，竹西佳处⑻，解鞍少驻初程。过春风十里⑻，尽荠麦青青。自胡马窥江去后⑽，废池乔木⑾，犹厌言兵。渐黄昏，清角吹寒⑿，都在空城。
杜郎俊赏⒀，算而今、重到须惊。纵豆蔻词工⒁，青楼梦好⒂，难赋深情。二十四桥仍在⒃，波心荡、冷月无声。念桥边红药⒄，年年知为谁生？", "explanation": "

　　⑴此调为姜夔自度曲，后人多用以抒发怀古之思。又名《郎州慢》，上下阕，九十八字，平韵。　
　　⑵淳熙丙申：淳熙三年（1176）。至日：冬至。

", "translation": "

　　淳熙年丙申月冬至这天，我经过扬州。夜雪初晴，放眼望去，全是荠草和麦子。进入扬州，一片萧条，河水碧绿凄冷，天色渐晚，城中响起凄凉的号角。我内心悲凉，感慨于扬州城今昔的变化，于是自创了这支曲子。千岩老人认为这首词有《黍离》的悲凉意蕴。

", "appreciation": "

　　姜夔有十七首自度曲，这是写得最早的一首。上片纪行，下片志感。时届岁暮，“春风十里”用杜牧诗，并非实指行春风中，而是使人联想当年楼阁参差、珠帘掩映的“春风十里扬州路”的盛况。

", "author": "姜夔" } ] } }

API错误码：

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

系统错误码：

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