### 3.4.12 格言 #### (1)功能说明 查询名人名言,可通过名言中的关键词或者名人的名字来查询,如“我要查关键词是天才的名言”、“来个鲁迅的名言”。名人范围为90年代前的名人。支持多轮查询,如“再来一个”,不支持英文查询&类别查询(如“励志名言”、“高考名言”)。 #### (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: "4166d1f5-18dc-4316-bd63-12e9a9ccca3f", intents: [ { parameters: { key: "70617dd808f24244a91b3e2c1a25244f", keyword: "鲁迅", any: "", 名言: "名言" }, action: "test", name: "名人和关键词-共用", result: { code: 200, response: { total: 165, result: [ { famous_name: "鲁迅", famous_saying: "爱看书的青年,大可以看看本分以外的书,即课外书……譬如学理科的,偏看看文学书,学文学的,偏看看科学书,看看别人在那里研究的,究竟是怎么一回事。这样子,对于别人,别事,可以更深的了解。" }, { famous_name: "鲁迅", famous_saying: "奢侈和淫靡只是一种社会腐化的现像,决不是原因" }, { famous_name: "鲁迅", famous_saying: "人必须生活着,爱才有所附丽。" }, { famous_name: "鲁迅", famous_saying: "“不耻最后”。即使慢,驰而不息,纵令落后,纵令失败,但一定可以达到他所向的目标。" }, { famous_name: "鲁迅", famous_saying: "养成他们有耐劳作的体力,纯洁高尚的道德,广博自由能容纳新潮流的精神,也就是能在世界新潮流中游泳,不被淹没的力量。" }, { famous_name: "鲁迅", famous_saying: "惟有民魂是值得宝贵的,惟有它发扬起来,中国才真有进步。" }, { famous_name: "鲁迅", famous_saying: "与其找糊涂导师,倒不如自己走,可以省却寻觅的功夫,横竖他也什么都不知道。" }, { famous_name: "鲁迅", famous_saying: "在人生的路上,将血一滴一滴地滴过去,以饲别人,虽自觉渐渐瘦弱,也以为快乐。" }, { famous_name: "鲁迅", famous_saying: "凡事以理想为因,实行为果。" }, { famous_name: "鲁迅", famous_saying: "我想,普遍、永久、完全,这三件宝贝,自然是了不得的,不过也是作家的棺材钉,会将他钉死" }, { famous_name: "鲁迅", famous_saying: "苛求君子,宽纵小人,自以为明察秋毫,而实则反助小人张目。" }, { famous_name: "鲁迅", famous_saying: "哪里有天才,我是把别人喝咖啡的工夫都用在了工作上了。" }, { famous_name: "鲁迅", famous_saying: "如果痛苦换来的是结识真理、坚持真理,就应自觉的欣然承受,那时,也只有那时,痛苦穿掘着灵魂的深处,使人受了精神底苦刑而得到创伤,又即从这得伤和养伤和愈合中,得到苦的涤除,而上了苏生的路。" }, { famous_name: "鲁迅", famous_saying: "以过去和现在的铁铸一般的事实来测将来,洞若观火!" }, { famous_name: "鲁迅", famous_saying: "养成他们有耐劳作的体力,纯洁高尚的道德,广博自由能容纳新潮流的精神,也就是能在世界新潮流中游泳,不被淹没的力量" }, { famous_name: "鲁迅", famous_saying: "昔者初民,见天地万物,变异不常,其诸现象,又出于人力所能以上,则自造众说以解释之;凡所解释,今谓之神话" }, { famous_name: "鲁迅", famous_saying: "一碗酸辣汤,耳闻口讲的,总不如亲自呷一口的明白。" }, { famous_name: "鲁迅", famous_saying: "无论什么事,如果不断收集材料,积之十年,总可成一学者。" }, { famous_name: "鲁迅", famous_saying: "我的杂文,所写的常是一鼻、一嘴、一毛,但结合起来,已几乎是一形象的全体" }, { famous_name: "鲁迅", famous_saying: "文艺是国民精神所发的火光,同时也是引导国民精神的前途的灯火" } ], error_code: 0, reason: "Succes" }, text: "鲁迅——【哪里有天才,我是把别人喝咖啡的工夫都用在了工作上了。】", type: "dialog" }, outputs: [ { type: "wechat.text", property: { text: "鲁迅——【无论什么事,如果不断收集材料,积之十年,总可成一学者。】" } }, { type: "dialog", property: { text: "鲁迅——【如果痛苦换来的是结识真理、坚持真理,就应自觉的欣然承受,那时,也只有那时,痛苦穿掘着灵魂的深处,使人受了精神底苦刑而得到创伤,又即从这得伤和养伤和愈合中,得到苦的涤除,而上了苏生的路。】", emotion: "calm" } } ], score: "1.0", scoreColor: "c4", is_match: 1, id: "33c5d104-df52-41b3-9c85-aab9866449fe" } ], meta_process_milliseconds: 575 } } ``` **详细参数说明** | 名称 | 类型 | 说明 | | :--- | :--- | :--- | | service | String | 服务名称 | | keyword | String | 识别关键词 |