接口简介：

查询历史三国人物生平等详情。可用作教育教学，游戏等领域。



请求地址：

https://cn.apihz.cn/api/zici/sanguo.php



请求方式：

POST或GET。



请求参数：

【名称】【参数】【必填】【说明】

【用户ID】【id】【是】【用户中心的数字ID，例：id=10000000】

【用户KEY】【key】【是】【用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2】

【关键词】【words】【否】【不传则随机返回1条，可传人物名称，字，例：words=关羽】

【查询页码】【page】【否】【默认第1页，最大100页。例：page=1】



返回参数：

【名称】【参数】【说明】

【状态码】【code】【200成功，400错误】

【信息提示】【msg】【返回信息提示。】

【当前页码】【page】【当前页码。】

【数据集】【datas】【数据集。】

【姓名】【datas.name】【姓名。】

【国家】【datas.guo】【主要效忠国家。】

【性别】【datas.sex】【性别。】

【是否真实】【datas.real】【史实人物或虚构人物。】

【字】【datas.zi】【字。】

【拼音】【datas.py】【拼音。】

【年龄】【datas.age】【年龄。】

【生平】【datas.content】【生平。】



GET请求示例：

https://cn.apihz.cn/api/zici/sanguo.php?id=88888888&key=88888888&words=关羽

注意：示例里的ID与KEY为公共ID与KEY，共享每分钟调用频次限制，接口本身免费，请使用自己的ID与KEY，独享每分钟调用频次。每日调用无上限。



POST请求示例：

请根据开发语言自行POST。



返回数据示例：

示例：{"code":400,"msg":"通讯秘钥错误。"}

示例：

{

"code": 200,

"page": 1,

"msg": "本信息仅供参考。",

"datas": [{

"name": "关羽",

"guo": "主效：蜀",

"sex": "男",

"real": "史实人物",

"zi": "字：云长",

"py": "guān-yǔ",

"age": " 生卒(？-219)",

"content": "前将军。本字长生，亡命奔涿郡。与张飞追随刘备征战，当刘备为平原相时，他们俩为别部司马。二人与刘备寝则同床，恩若兄弟。稠人广坐则侍立终日。随同曹操和刘备讨吕布于下邳，事后为朝廷封为中郎将。当刘备袭杀曹操的徐州刺史车冑后，以关羽镇下邳太守。曹操东征破刘备，关羽被俘，被拜为偏将军，对他礼遇很优厚。白马之战时关羽万军中刺敌主帅颜良，被封为汉寿亭侯，报了曹操之恩后便告辞，寻找刘备。长阪之战刘备败北，抄近路赴汉津与关羽的数百只船汇合至江夏。赤壁之战孙刘联军胜利后，关羽在其后的江陵之战中绝北道，阻隔曹操的援军，为周瑜能攻下江陵创造有利的条件。事后遙领襄阳太守、拜为荡寇将军。诸葛亮等人入蜀增援刘备，关羽便镇荊州。刘备自立为汉中王，被拜为前将军，假节钺。关羽乘汉水暴涨之机出兵襄樊，更在于禁七军为水所淹乘船进攻，梁、郏、陆浑各县的盗贼有些远远地领受了关羽的官印封号，威震华夏；曹操一度想迁都避其锋芒。后因孙权背盟投曹，后方为吕蒙所破，关羽便退兵，但终为孙权军所擒杀。"

}]

}



参考资料(版权)：

https://www.apihz.cn/api/zicisanguo.html