元曲三百首API接口_免费数据接口

1、所有章节

接口地址：https://api.jisuapi.com/yuanqu/chapter

返回格式：JSON

请求方式：GET POST

请求示例：https://api.jisuapi.com/yuanqu/chapter?appkey=yourappkey

请求参数：

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
detailid	int	详情ID
name	string	名称
author	string	作者

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": "关汉卿"
        }
    ]
}

2、详情查询

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

返回格式：JSON

请求方式：GET POST

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

请求参数：

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

返回参数：

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

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "detailid": "1",
        "title": "鹦鹉曲",
        "content": "<p>　　侬家鹦鹉洲边住①， </p><p>　　是个不识字渔父②。 </p><p>　　浪花中一叶扁舟，睡煞江南烟雨。 </p><p>　　觉来时满眼青山暮③，抖擞绿蓑归去。 </p><p>　　算从前错怨天公，甚也有安排我处④。 </p>",
        "explanation": "<p>　　①鹦鹉洲：在今武汉市汉阳西南长江中。 </p><p>　　②父：对老年男人的称呼。 </p><p>　　③觉来时满眼青山暮：醒来时感到满眼青山都染上了暮色。 </p><p>　　④甚也有安排我处：甚，此处做“是”讲。指天公安排他作了渔父。</p>",
        "appreciation": "<p>　　乍看该曲是礼赞隐逸生活，实则是抒发怀才不遇的愤懑。说自己是个不识字渔夫实为对社会的愤激之语。以下所描绘的自由自在的渔父生活，也可作如是观。“算从前错怨天公”的“算”字，是习用的勉强承认的词。“错怨天公”作者是怨天公没有给他安排一个能够发挥才能的地位。“甚也有安排我处”也并非从心里表示满意。此处“甚”字，也是带有勉强承认的语气，实质是对天公的安排，极大不满，暗含着怀才不遇的怨愤。这种情绪，在元代一般汉族文人中普遍存在。当时，在民族歧视政策下，汉族文士多不能为国所用。白贲自然亦然，只是作些地方小官，且为时短暂。这支曲道出了当时一般文士共有的心声。 </p>",
        "author": "白贲"
    }
}

3、元曲查询

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

返回格式：JSON

请求方式：GET POST

请求示例：https://api.jisuapi.com/yuanqu/search?appkey=yourappkey&keyword=百姓苦

请求参数：

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

返回参数：

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

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "total": "1",
        "pagenum": "1",
        "pagesize": "1",
        "list": [
            {
                "title": "山坡羊",
                "content": "潼关怀古<br />峰峦如聚[一]，波涛如怒，山河表里潼关路[二]，望西都[三]，意踟蹰[四]。伤心秦汉经行处[五]，宫阙万间都做了土[六]。兴，百姓苦；亡，百姓苦。 骊山怀古<br />骊山四顾[七]，阿房一炬[八]，当时奢侈今何处？只见草萧疏，水萦纡[九]。至今遗恨迷烟树，列国周齐秦汉楚[十]，赢，都变做了土；输，都变做了土。",
                "explanation": "<p>[一]峰峦如聚：言重岩迭嶂，群山攒立，连绵不断。</p><p>[二]“山河”句：言潼关外有黄河，内有华山，形势十分险要，潼关：在今陕西省潼关县北，历代皆为军事要地。 </p><p>[三]西都：指长安（今陕西西安）。 </p>",
                "translation": "",
                "appreciation": "",
                "author": "张养浩"
            }
        ]
    }
}

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

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

会员等级	权限
免费会员	100次/日
白银会员	500次/日
钻石会员	不限次

元曲三百首

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

API错误码

系统错误码