### 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 | 识别关键词 |