目录



网站API使用介绍


本网站上也提供了一些比较有趣的API,可以让大家调用,比如毒鸡汤、唐诗宋词等等,这边文章就是用于介绍API调用方式。

毒鸡汤

该API大部分数据来源于仓库https://github.com/egotong/nows,感谢这位老哥的数据,同时我自己也添加了一些数据。

API信息如下所示

连接:http://2dogz.cn/api/get-soul/
参数:counts
方式:GET 

 1.获取一条信息

使用get的方式发送请求,Python示例如下所示

import requests

res = requests.get('http://2dogz.cn/api/get-soul/')
print(res.text)

返回结果如下

{
  "code": 200, 
  "result": [
    {
      "hits": "29", 
      "title": "如果我有什么,让你不喜欢的地方,麻烦你自己克服一下。"
    }
  ]
}

默认的当你不指定counts参数的时候,就会随机返回一条毒鸡汤文本。

2.获取指定条目毒鸡汤文本

使用get的方式发送请求,指定获取三条毒鸡汤文本,Python示例如下所示

import requests

res = requests.get('http://2dogz.cn/api/get-soul/?counts=3')
print(res.text)

 返回结果如下:

{
  "code": 200, 
  "result": [
    {
      "hits": "23", 
      "title": "考试真是so easy,哪里不会考哪里!"
    }, 
    {
      "hits": "49", 
      "title": "如果你很忙,除了你这真的很重要之外,更可能的原因是:你很弱"
    }, 
    {
      "hits": "26", 
      "title": "我的眼里只有你,因为你的大脸,让我看不到别人。"
    }
  ]
}

3.获取所有毒鸡汤文本

import requests

res = requests.get('http://2dogz.cn/api/get-soul/?counts=all')
print(res.text)

返回结果如下

"code": 200, 
  "result": [
    {
      "hits": "31", 
      "title": "所谓成长,就是在听到波涛汹涌四个字,再也联想不到大海了。"
    }, 
    {
      "hits": "25", 
      "title": "一些年轻人,通过高端消费来营造自己高端收入的形象。"
    }, 
    {
      "hits": "42", 
      "title": "一个姑娘的介绍:思想上的女流氓,生活中的好姑娘。 然而给我的感觉是:心思活络的丑逼。"
    }, 
...} 

当发送请求的时候指定参数counts=all的时候,我们就可以获取所有的毒鸡汤文本。 

唐宋诗

通过这个系列的API可以获取到数据库中已存的唐宋诗词内容。

整个库的数据来源于这个开源项目,感谢各位贡献者~ 连接:chinese-poetry

1. 随机获取一首唐诗

连接:http://2dogz.cn/api/get-ts-poem/
参数:counts
方式:GET

Python代码如下

import requests

res = requests.get('http://2dogz.cn/api/get-ts-poem/')
print(res.text)

返回结果如下:

{
    "code": 200,
    "counts": 1,
    "result": [{
        "author": "宋·周紫芝",
        "content": "黄昏雪意未全成,寒入重衾晓更清。风里未看穿幕片,梦中先听打窗声。",
        "id": 234306,
        "title": "闻雪二首  其一"
    }]
}

2.获取指定条目的唐宋诗

Python代码如下

import requests

res = requests.get('http://2dogz.cn/api/get-ts-poem/?counts=3')
print(res.text)

返回结果如下:

{
    "code": 200,
    "counts": 3,
    "result": [{
        "author": "宋·袁说友",
        "content": "源委萦苕霅,乾坤接水云。半天孤月照,两派一溪分。日落虹垂影,鱼翻縠断纹。烟波岂无义,泾渭固难羣。",
        "id": 224580,
        "title": "双溪亭"
    }, {
        "author": "宋·王铚",
        "content": "夜久灯花自吐红,岁华已尽尚飘蓬。身游百越风波外,路入千山雨雪中。失马旧知无得丧,拂龟那更问穷通。懒将今古从头数,几度邯郸梦不同。",
        "id": 236838,
        "title": "夜坐"
    }, {
        "author": "宋·陆游",
        "content": "新绿成阴小雨时,幅巾萧散与闲宜。燕归赴诉经年别,莺晚分疏出谷迟。晓枕呼儿投宿酒,暮窗留客算残棋。翛然此意风尘表,正恐羲皇未必知。",
        "id": 152918,
        "title": "春晚"
    }]

当我们在发送请求的时候,指定参数counts时,就会获取到指定条目数的唐宋诗。

注意: counts <= 50

3.根据标题获取唐宋诗

连接:http://2dogz.cn/api/get-ts-poem/title/
参数:title
方式:GET

Python代码如下,获取静夜思的内容。

import requests

res = requests.get('http://2dogz.cn/api/get-ts-poem/title/?title=静夜思')
print(res.text)

返回结果

{
    "code": 200,
    "counts": 1,
    "result": [{
        "author": "唐·李白",
        "content": "牀前看月光,疑是地上霜。举头望山月,低头思故乡。",
        "id": 127890,
        "title": "静夜思"
    }]
}

注意:该API会返回所有与title绝对匹配的诗。

 4.根据作者获取诗集

连接:http://2dogz.cn/api/get-ts-poem/poet/
参数:author, counts
方式:GET

使用该API时,author必须指定,counts参数为可选参数,可以指定一个数值或者指定为all当指定为all时,会返回该作者所有的诗。

获取一首李白的诗,Python代码如下

import requests

res = requests.get('http://2dogz.cn/api/get-ts-poem/poet/?author=李白')
print(res.text)

返回结果如下

{
    "code": 200,
    "counts": 1,
    "result": [{
        "author": "唐·李白",
        "content": "风动荷花水殿香,姑苏台上宴吴王。西施醉舞娇无力,笑倚东窗白玉牀。",
        "id": 128649,
        "title": "口号吴王美人半醉"
    }]

当指定counts时

counts=3

url: http://2dogz.cn/api/get-ts-poem/poet/?author=李白&counts=3

 返回结果

{
    "code": 200,
    "counts": 3,
    "result": [{
        "author": "唐·李白",
        "content": "汉家秦地月,流影照明妃。一上玉关道,天涯去不归。汉月还从东海出,明妃西嫁无来日。燕支长寒雪作花,蛾眉顦顇没胡沙。生乏黄金枉图画,死留青冢使人嗟。",
        "id": 59765,
        "title": "相和歌辞 王昭君二首 一"
    }, {
        "author": "唐·李白",
        "content": "韩众骑白鹿,西往华山中。玉女千馀人,相随在云空。见我传祕诀,精诚与天通。何意到陵阳,游目送飞鸿。天子昔避狄,与君亦乘骢。拥兵五陵下,长策遏胡戎。时泰解绣衣,脱身若飞蓬。鸾凤翻羽翼,啄粟坐樊笼。海鹤一笑之,思归向辽东。黄山过石柱,巘崿上攒丛。因巢翠玉树,忽见浮丘公。又引王子乔,吹笙舞松风。朗咏紫霞篇,请开蘂珠宫。步纲绕碧落,倚树招青童。何日可携手,遗形入无穷。",
        "id": 128329,
        "title": "至陵阳山登天柱石詶韩侍御见招隐黄山"
    }, {
        "author": "唐·李白",
        "content": "我来竟何事,高卧沙丘城。城边有古树,日夕连秋声。鲁酒不可醉,齐歌空复情。思君若汶水,浩荡寄南征。",
        "id": 128126,
        "title": "沙丘城下寄杜甫"
    }]
}

couts=all

url: http://2dogz.cn/api/get-ts-poem/poet/?author=李白&counts=all
{
    "code": 200,
    "counts": 1203,
    "result": [{
        "author": "唐·李白",
        "content": "三十六离宫,楼台与天通。阁道步行月,美人愁烟空。恩疎宠不及,桃李伤春风。淫乐意何极,金舆向回中。万乘出黄道,千旗扬彩虹。前军细柳北,后骑甘泉东。岂问渭川老,宁邀襄野童。秋暮瑶池宴,归来乐未穷。",
        "id": 852,
        "title": "鼓吹曲辞 上之回"
    }, {
        "author": "唐·李白",
        "content": "去年战桑干源,今年战葱河道。洗兵条支海上波,放马天山雪中草。万里长征战,三军尽衰老。匈奴以杀戮为耕作,古来唯见白骨黄沙田。秦家筑城备胡处,汉家还有烽火然。烽火然不息,征战无已时。野战格鬬死,败马号鸣向天悲。乌鸢啄人肠,衔飞上挂枯树枝。士卒涂草莽,将军空尔为。乃知兵者是凶器,圣人不得已而用之。",
        "id": 855,
        "title": "鼓吹曲辞 战城南"
    }, {
        "author": "唐·李白",
        "content": "君不见黄河之水天上来,奔流到海不复回。君不见高堂明镜悲白发,朝如青丝暮成雪。人生得意须尽欢,莫使金尊空对月。天生我材必有用,千金散尽还复来。烹羊宰牛且为乐,会须一饮三百杯。岑夫子,丹丘生,将进酒,杯莫停。与君歌一曲,请君为我侧耳听。钟鼓馔玉不足贵,但愿长醉不复醒。古来圣贤皆寂寞,惟有饮者留其名。陈王昔时宴平乐,斗酒十千恣欢谑。主人何为言少钱,径须酤取对君酌。五花马,千金裘,呼儿将出换美酒,与尔同销万古愁。",
        "id": 872,
        "title": "鼓吹曲辞 将进酒"
    },省略下面部分
]} 

宋词

通过这个系列的API可以获取到数据库中已存的宋词内容。

整个库的数据来源于这个开源项目,感谢各位贡献者~ 连接:chinese-poetry

1. 随机获取一首宋词

连接:http://2dogz.cn/api/get-song-ci/
方式:GET

Python代码如下 

import requests

res = requests.get('http://2dogz.cn/api/get-song-ci/')
print(res.text)

结果如下

{
  "code": 200, 
  "counts": 1, 
  "result": [
    {
      "author": "宋·朱敦儒", 
      "content": "老後人间无去处。多谢碧桃留我住。红尘回步旧烟霞,清境开扉新院宇。隐几日长香一缕。风散飞花红不聚。眼前寻见自家春,罢问玉霄云海路。", 
      "id": 3645, 
      "title": "木兰花・玉楼春"
    }
  ]
}

2. 随机获取指定数目宋词

连接:http://2dogz.cn/api/get-song-ci/
参数:counts
方式:GET 

Python代码如下,加入counts参数 

import requests

res = requests.get('http://2dogz.cn/api/get-song-ci/?counts=3')
print(res.text)

结果如下

{
  "code": 200, 
  "counts": 3, 
  "result": [
    {
      "author": "宋·蔡伸", 
      "content": "堆枕乌云堕翠翘。午梦惊回,满眼春娇。一袅楚宫腰。那更春来,玉减香消。柳下朱门傍小桥。几度红窗,误认鸣镳。断肠风月可怜宵。忍使恹恹,两处无聊。", 
      "id": 12006, 
      "title": "一翦梅"
    }, 
    {
      "author": "宋·舒亶", 
      "content": "紫雾香浓,岁华风转花随辇。洞天云暖。一片笙歌远。水殿龙舟,忆侍瑶池宴。闲庭院。梦回春半。雪鬓无人见。", 
      "id": 6915, 
      "title": "点绛唇"
    }, 
    {
      "author": "宋·楼钥", 
      "content": "茫茫。苍苍。青山绕、千顷波光。新秋露风荷吹香。悠心地け然,生清凉。古岸摇垂杨。时有白鹭飞来双。隐君如在,鹤与翱翔。老仙何处,尚有流风未忘。琴与君兮宫商。酒与君兮杯觞。清欢殊未央。西山忽斜阳。欲去且徜徉。更将霜鬓临沧浪。", 
      "id": 14897, 
      "title": "醉翁操"
    }
  ]
} 

因为携带了参数counts=3,所以返回了三条宋词。整个API的counts不能超过50,否则返回报错信息。

 3. 根据作者随机获取词

连接:http://2dogz.cn/api/get-song-ci/poet/
参数:author、counts
方式:GET 

Python代码如下加入author参数 

import requests

res = requests.get('http://2dogz.cn/api/get-song-ci/poet/?author=苏轼')
print(res.text)

结果如下 

{
  "code": 200, 
  "counts": 1, 
  "result": [
    {
      "author": "宋·苏轼", 
      "content": "娟娟侵鬓妆痕浅。双颦相媚弯如翦。一瞬百般宜。无论笑与啼。酒阑思翠被。特故腾腾地。生怕促归轮。微波先注人。", 
      "id": 6704, 
      "title": "菩萨蛮"
    }
  ]
}

 因为没有指定counts所以随机返回一条。

指定counts=3

import requests

res = requests.get('http://2dogz.cn/api/get-song-ci/poet/?author=苏轼&counts=3')
print(res.text)

结果如下 

{
  "code": 200, 
  "counts": "3", 
  "result": [
    {
      "author": "宋·苏轼", 
      "content": "麻叶层层苘叶光。谁家煮蚕一村香。隔篱娇语络丝娘。垂白杖藜抬醉眼,捋青捣麨软饥肠。问言豆叶几时黄。", 
      "id": 6669, 
      "title": "浣溪沙"
    }, 
    {
      "author": "宋·苏轼", 
      "content": "紫陌寻春去,红尘拂面来。无人不道看花回。惟见石榴新蕊、一枝开。冰簟堆云髻,金尊滟玉醅。绿阴青子莫相催。留取红巾千点、照池台。", 
      "id": 6525, 
      "title": "南歌子"
    }, 
    {
      "author": "宋·苏轼", 
      "content": "莺初解语。最是一年春好处。微雨如酥。草色遥看近却无。休辞醉倒。花不看开人易老。莫待春回。颠倒红英间绿苔。", 
      "id": 6715, 
      "title": "减字木兰花"
    }
  ]
}

当指定counts=all时,会返回所有属于该作者的词。

 4. 根据标题作者获取词

连接:http://2dogz.cn/api/get-song-ci/title/
参数:title、author
方式:GET 

其中title为必须参数,author为可选

只指定title

import requests

res = requests.get('http://127.0.0.1:5000/api/get-song-ci/title/?title=定风波')
print(res.text)

结果如下 

{
  "code": 200, 
  "counts": 81, 
  "result": [
    {
      "author": "宋·曹冠", 
      "content": "万个琅玕筛日影,两堤杨柳蘸涟漪。鸣鸟一声林愈静。吟兴。未曾移步已成诗。旋汲清湘烹建茗,时寻野果劝金卮。况有良朋谈妙理。适意。此欢莫遣俗人知。", 
      "id": 2570, 
      "title": "定风波"
    }, 
    {
      "author": "宋·管鉴", 
      "content": "秋入华堂一味清。四山环碧眼双明。欲送主人天上去。无绪。一尊已带别离情。洞府桃花常许见。□□。为谁特地惜娉婷。祗待明年春醉里。偎倚。耳边听唤状元声。", 
      "id": 2706, 
      "title": "定风波"
    }, 
    {
      "author": "宋·陆游", 
      "content": "帽垂鞭送客回。小桥流水一枝梅。衰病逢春都不记。谁谓。幽香却解逐人来。安得身闲频置酒。携手。与君看到十分开。少壮相从今雪鬓。因甚。流年羁恨两相催。", 
      "id": 2788, 
      "title": "定风波"
    }, ...]}

指定title、author 

不同诗歌,因为词的词牌名有很多一样的,所以做了一个作者筛选。

import requests

res = requests.get('http://127.0.0.1:5000/api/get-song-ci/title/?title=定风波&author=苏轼')
print(res.text)

结果如下 

{
  "code": 200, 
  "counts": 11, 
  "result": [
    {
      "author": "宋·苏轼", 
      "content": "两两轻红半晕腮。依依独为使君回。若道使君无此意。何为。双花不向别人开。但看低昂烟雨里。不已。劝君休诉十分杯。更问尊前狂副使。来岁。花开时节与谁来。", 
      "id": 6491, 
      "title": "定风波"
    }, 
    {
      "author": "宋·苏轼", 
      "content": "莫听穿林打叶声。何妨吟啸且徐行。竹杖芒鞋轻胜马。谁怕。一蓑烟雨任平生。料峭春风吹酒醒。微冷。山头斜照却相迎。回首向来萧瑟处。归去。也无风雨也无晴。", 
      "id": 6492, 
      "title": "定风波"
    }, 
    {
      "author": "宋·苏轼", 
      "content": "与客携壶上翠微。江涵秋影雁初飞。尘世难逢开口笑。年少。菊花须插满头归。酩酊但酬佳节了。云峤。登临不用怨斜晖。古往今来谁不老。多少。牛山何必更沾衣。", 
      "id": 6493, 
      "title": "定风波"
    }, ...]}

 

至此,本站所有的API就已经介绍完了,如在使用过程中有任何问题,可以联系我,联系方式见首页。