目录



网站API使用介绍

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

毒鸡汤

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

API信息如下所示

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

 1.获取一条信息

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

import requests

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

返回结果如下

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

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

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

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

import requests

res = requests.get('https://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('https://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('https://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('https://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('https://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('https://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: https://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: https://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. 随机获取一首宋词

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

Python代码如下 

import requests

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

结果如下

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

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

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

Python代码如下，加入counts参数 

import requests

res = requests.get('https://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. 根据作者随机获取词

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

Python代码如下加入author参数 

import requests

res = requests.get('https://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('https://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. 根据标题作者获取词

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

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

只指定title

import requests

res = requests.get('https://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('https://2dogz.cn/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就已经介绍完了，如在使用过程中有任何问题，可以联系我，联系方式见首页。