### 3.7.1 人物百科 #### (1) 功能说明 人物百科问答包含著名诗人、演员、歌手、历史人物等60万+百科人物数据,支持简介、出生日期、出生地、死亡日期、代表作、获得奖项、朝代、主要成就、别名、宗教、职业等50+属性查询。 #### (2) 接口说明 **请求方法** * POST **请求地址** * [http://api.ruyi.ai/v1/message](http://api.ruyi.ai/v1/message) **请求参数说明** | 参数名 | 参数类型 | 是否必须 | 参数说明 | | :--- | :--- | :---: | :--- | | q | String | 是 | 自然语言表达,例如“周杰伦是谁”,"孙中山是什么党派"等 | | app\_key | String | 是 | 应用开发者秘钥,注册开发者后台账号,建立虚拟助理后获得 | | user\_id | String | 是 | 用户唯一标识,便于支持个性化语义解析。建议开发者使用 UUID 字符,且不同用户必须用不同的 user\_id,防止意图串。 | #### (3) 返回说明 **返回参数说明** | 名称 | 类型 | 说明 | | :--- | :--- | :--- | | code | Integer | 返回代码 | | msg | String | 返回代码描述 | | parameters | JSON Object | 解析到的实体以及服务说明 | | action | String | 服务的接口名称 | | name | String | 匹配的意图名称 | | result | JSON Object | 接口返回内容 | | outputs | Array | 服务输出结果,微信端使用 type 类型为 wechat 开头的内容;硬件端收到所有内容,依据需求解析使用 | **返回代码说明** | 返回代码 | 错误类型 | 说明 | | :--- | :--- | :--- | | 0/200 | 成功 | 请求成功 | | 400 | 无效请求 | 某些必需参数缺失或参数值错误,详见msg字段 | | 401 | 未授权 | 授权失败,app\_key 缺失或错误 | | 403 | 请求被禁止 | 有效请求,但服务拒绝响应,请联系contact@ruyi.ai | | 408 | 请求超时 | 请求响应超时,一般响应时间设置为2000ms以内 | | 429 | 短时间内大量访问 | 短时间内请求数过多 | | 500 | 内部错误 | 服务处理异常 | | 503 | 服务不可用 | 服务异常或正在维护 | #### (4) 请求示例 **请求范例** _刘备是谁_ _刘备的图片_ _居里夫人的国籍_ _姚明的身高_ _姚明的体重_ _姚明毕业于哪所高校_ _刘备在哪里出生_ _刘备生于哪一年_ _刘备死于哪一年_ _刘备去世的地方在哪里_ _居里夫人的职业_ _刘备的主要成就_ _刘备的性别_ _刘备是哪个朝代的人_ _玄德是谁_ _刘备的年号叫什么_ _刘备的庙号是_ _昭烈皇帝是谁_ _刘备的陵寝_ _刘备是汉族吗_ _孙中山的代表作_ **请求示例** * http://api.ruyi.ai/ruyi-api/v1/message?app_key=APP_KEY&user_id=user0&q=孙中山是谁 返回结果 ```json { code: 0, msg: "ok", result: { _text: "孙中山是谁", msg_id: "a697dd17-bcba-499a-bfea-19193afff4d3", intents: [{ parameters: { id: "3323b4c6-e42d-3474-8196-ffb4e8eba771", name: "孙中山" }, action: "kg.entities", name: "描述-description", result: { code: 200, response: { birthPlace: "广东省香山县翠亨村(今中山市南朗镇翠亨村)", description: "孙中山,名文,字载之,号日新,又号逸仙,幼名帝象,化名中山樵", image: "http://f.hiphotos.baidu.com/baike/w%3D268%3Bg%3D0/sign=107d70ae2b34349b74066983f1d172f3/80cb39dbb6fd5266e546ada0a818972bd4073610.jpg", birthDate: "1866年11月12日", keywords: [ "政治人物", "元首", "人物" ], nationality: "中国", alternateName: [ "Sun Yat-sen", "中山", "逸仙", "载之", "日新", "中山樵", "帝象", "SunYatsen" ], deathDate: "1925年3月12日", @id: "3323b4c6-e42d-3474-8196-ffb4e8eba771", occupation: "革命家", placeOfBurial: "江苏省南京市玄武区中山陵", name: "孙中山", authorOf: "《民权初步》、《孙文学说》、《三民主义》、《实业计划》等", accomplishment: "1905年8月20日成立中国同盟会建立共和体制、建立中国国民党开创中华民国、创建黄埔军校、中山大学领导二次革命和护法运动", alumniOf: "香港西医书院(今香港大学)", memberOfPoliticalParty: "兴中会,中国同盟会,中国国民党", ethnicGroup: "汉族", @type: [ "Person", "Thing" ] }, text: "孙中山,名文,字载之,号日新,又号逸仙,幼名帝象,化名中山樵", type: "dialog" }, outputs: [{ type: "wechat.text", property: { text: "孙中山,名文,字载之,号日新,又号逸仙,幼名帝象,化名中山樵" } }, { type: "dialog", property: { text: "孙中山,名文,字载之,号日新,又号逸仙,幼名帝象,化名中山樵", emotion: "calm" } } ], score: "1.0", scoreColor: "c4", is_match: 1, id: "aea767c5-228e-4e9f-b24e-f64988557fcf" }], meta_process_milliseconds: 131 } } ``` 人物属性说明 cnschema字段| 中文属性名| |---|--- |name |姓名 |alternateName |别名 |description |简介 |image |图片 |keywords |标签 |birthPlace |出生地 |birthDate| 出生日期 |deathDate| 死亡日期 |deathPlace| 死亡地 |placeOfBurial |墓地、安葬地 |gender |性别 |children| 子女 |parent| 父母 |sibling| 兄弟姐妹 |spouse |配偶、爱人 |husband |丈夫 |wife |妻子 |colleague |同事,队友、战友 |unmarriedPartner| 情侣 |studentOf |老师、师傅、导师 |student |学生、弟子、徒弟、门徒 |height| 身高 |weight |体重 |nationality| 国籍 |worksFor |工作单位 |jobTitle |工作职务、职位 |workLocation |工作地址 |homeLocation| 家庭地址 |alumniOf |毕业院校 |ancestralHome |籍贯 |occupation| 职业、身份 |cnProfessionalTitle |职称 |fieldOfWork |领域,专业 |academicMajor| 高校专业 |ethnicGroup |民族、民族族群 |nobleFamily| 家族 |religion| 宗教信仰、信仰 |memberOfPoliticalParty |政党、党派 |courtesyName |字、表字 |artName |号 |templeName |庙号 |posthumousName| 谥号、私谥 |pseudonym |化名 |birthName |原名 |familyName| 姓氏 |accomplishment |主要成就 |authorOf |作品、代表作 |award |奖项, 获奖 |earName |年号 |dynasty |朝代、所在年代、所处时代 |phoneNumber| 电话 |email |邮件 |father |父亲 |mother| 母亲 |dharmaName| 法号、法名 |schoolsOfBuddhism |宗派 |nobleTitle| 爵位、官爵、封爵、封号 |alumniOf| 毕业院校 |academicMajor| 所学专业 |academicDegree |学位 |cnEducationalAttainment |学历