接口调用地址
说明:直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成,通过IP接口地址调用,如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击,平台可能不定期更换。
说明:域名接口会自动分发请求到普通集群服务器均衡负载,该域名TTL值为60秒,表示你的请求会每60秒实现自动轮换负载服务器,但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障,也可能会造成个别地区存在一定时间的故障期。
说明:VIP专线在普通集群组的基础上额外增加独享大带宽集群组,每次请求自动均衡负载,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!最低30¥/月,彩钻以上会员专属,登录后购买。注:VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等,并非收费接口包月使用。
请求示例
[GET]请求示例:(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例:(请根据开发语言自行POST,参考【GET/POST教程】,或下载【超级客户端】调试。)
请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。参数内容较大的必须用POST,不能GET。
提示:如发现接口有BUG,可加服务QQ群及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
提示:如发现接口有BUG,可加服务QQ群及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
| 查询关键词 | words | 是 | 查询关键词,可以是诗人名字,诗句内容,诗文标签如:小学,等关键词。长度1-50。例:words=李白 |
| 页码 | page | 否 | 查询页码,每页最多返回5首诗文,最大查询50页,默认第1页。例:page=1 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功,400错误 |
| 信息提示 | msg | 信息提示。 |
| 页码 | page | 当前页码。 |
| 结果集 | data | 结果数据集。 |
| 诗文标题 | data.name | 诗文标题。 |
| 诗文内容 | data.content | 诗文内容。注意诗文及下面各字段内容可能包含HTML元素,可直接用于网页显示,也可自行去除HTML元素。 |
| 诗文作者 | data.author | 诗文作者。 |
| 所属朝代 | data.dynasty | 所属朝代。 |
| 诗词标签 | data.tag | 诗词标签。 |
| 译文及注释一 | data.ywjzsy | 译文及注释一。 |
| 译文及注释二 | data.ywjzse | 译文及注释二。 |
| 创作背景 | data.czbj | 创作背景。 |
| 鉴赏一 | data.jsy | 鉴赏一。 |
| 鉴赏二 | data.jse | 鉴赏二。 |
| 赏析一 | data.sxy | 赏析一。 |
| 赏析二 | data.sxe | 赏析二。 |
| 句解 | data.jj | 句解。 |
| 文言知识 | data.wyzs | 文言知识。 |
| 意境 | data.yj | 意境。 |
| 写作手法 | data.xzsf | 写作手法。 |
| 读解 | data.dj | 读解。 |
| 评价 | data.pj | 评价。 |
| 简析 | data.jx | 简析。 |
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
"code": 200,
"page": 1,
"data": [{
"name": "白马篇",
"content": "龙马花雪毛,金鞍五陵豪。秋霜切玉剑,落日明珠袍。斗鸡事万乘,轩盖一何高。弓摧南山虎,手接太行猱。酒后竞风采,三杯弄宝刀。杀人如剪草,剧孟同游遨。发愤去函谷,从军向临洮。叱咤经百战,匈奴尽奔逃。归来使酒气,未肯拜萧曹。羞入原宪室,荒淫隐蓬蒿。",
"author": "李白",
"dynasty": "唐代",
"tag": "描写马",
"ywjzsy": null,
"ywjzse": null,
"czbj": null,
"jsy": null,
"jse": null,
"sxy": null,
"sxe": null,
"jj": null,
"wyzs": null,
"yj": null,
"xzsf": null,
"dj": null,
"pj": null,
"jx": null
}, {
"name": "书《龙马图》",
"content": "先皇御马三千匹,仗下曾骑玉骆骢。金鼎丹成龙亦化,圉人空栈泣西风。",
"author": "苏轼",
"dynasty": "宋代",
"tag": null,
"ywjzsy": null,
"ywjzse": null,
"czbj": null,
"jsy": null,
"jse": null,
"sxy": null,
"sxe": null,
"jj": null,
"wyzs": null,
"yj": null,
"xzsf": null,
"dj": null,
"pj": null,
"jx": null
}, {
"name": "临别成都帐饮万里桥赠谭德称",
"content": "成都城南万里桥,芦根苹末风萧萧。映花碾草钿车小,驻坡蓦涧青骢骄。入门翠径绝窈窕,临水飞观何迢嶢。判无功名著不朽,惟仗诗酒宽无聊。迎霜早已足雉兔,微冷便欲思狐貂。喜看缕脍映盘箸,恨欠斫蟹加橙椒。坐中谭侯天下士,龙马毛骨矜超遥。乌犀白紵谪僊样,但可邂逅不可招。今年一战馘余子,风送六翮凌青霄。美人再拜乞利市,醉墨飞落生蛟绡。我衰於世百无用,十年不趁含元朝。华缨肯傍萧飒鬓,宝带那束龙锺腰。祝君好去事明主,日望分喜来渔樵。游谈引类亦细事,寄酒且解相如消。",
"author": "陆游",
"dynasty": "宋代",
"tag": null,
"ywjzsy": null,
"ywjzse": null,
"czbj": null,
"jsy": null,
"jse": null,
"sxy": null,
"sxe": null,
"jj": null,
"wyzs": null,
"yj": null,
"xzsf": null,
"dj": null,
"pj": null,
"jx": null
}, {
"name": "赛神曲",
"content": "男抱琵琶女作舞,主人再拜听神语。新妇上酒勿辞勤,使尔舅姑无所苦。椒浆湛湛桂座新,一双长箭系红巾。但愿牛羊满家宅,十月报赛南山神。青天无风水复碧,龙马上鞍牛服轭。纷纷醉舞踏衣裳,把酒路旁劝行客。",
"author": "王建",
"dynasty": "唐代",
"tag": null,
"ywjzsy": null,
"ywjzse": null,
"czbj": null,
"jsy": null,
"jse": null,
"sxy": null,
"sxe": null,
"jj": null,
"wyzs": null,
"yj": null,
"xzsf": null,
"dj": null,
"pj": null,
"jx": null
}, {
"name": "次韵答崔元初",
"content": "楼居依约近蓬莱,每见天官簇仗来。星绕紫微双阙近,日临仙掌五云开。旌旗影动黄金表,龙马风生白玉台。遥望上林花隐隐,乾坤清气一时回。",
"author": "王冕",
"dynasty": "元代",
"tag": null,
"ywjzsy": null,
"ywjzse": null,
"czbj": null,
"jsy": null,
"jse": null,
"sxy": null,
"sxe": null,
"jj": null,
"wyzs": null,
"yj": null,
"xzsf": null,
"dj": null,
"pj": null,
"jx": null
}]
}
更新记录