### 3.7.3 实时百科 #### (1) 功能说明 通过在线搜索实时答案。开发者为合肥阿拉丁智能。 #### (2) 接口说明 **请求方法** * POST **请求地址** * 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=青岛有什么好玩的 返回结果 ``` { "code": 0, "msg": "ok", "result": { "_text": "青岛有什么好玩的", "msg_id": "20faeca1-d0f5-498a-85f1-e78f688ee372", "intents": [{ "parameters": { "key": "68a1ff5fdc8824ee", "words": "青岛有什么好玩的", "format": "0", "name": "haizhi", "smode": "0", "multiflag": "11111100" }, "action": "阿拉丁", "name": "阿拉丁", "result": { "code": 200, "response": { "robot_output": "青岛地区历经沧桑,有着丰富的文化旅游景观,根据景观的空间分布和文化内涵,可分为各具特色的四大区域,即:西部旧城区、东部新区、市区腹地、郊区。到青岛来游览,即可享受宜人的气候和优美的风光。又可在观赏中外文化碰撞交融的结晶中产生深层次的思索和启迪,因而具有很高的旅游美学价值。", "wav_path": "none" }, "text": "青岛地区历经沧桑,有着丰富的文化旅游景观,根据景观的空间分布和文化内涵,可分为各具特色的四大区域,即:西部旧城区、东部新区、市区腹地、郊区。到青岛来游览,即可享受宜人的气候和优美的风光。又可在观赏中外文化碰撞交融的结晶中产生深层次的思索和启迪,因而具有很高的旅游美学价值。", "type": "dialog" }, "outputs": [{ "type": "wechat.text", "property": { "text": "青岛地区历经沧桑,有着丰富的文化旅游景观,根据景观的空间分布和文化内涵,可分为各具特色的四大区域,即:西部旧城区、东部新区、市区腹地、郊区。到青岛来游览,即可享受宜人的气候和优美的风光。又可在观赏中外文化碰撞交融的结晶中产生深层次的思索和启迪,因而具有很高的旅游美学价值。" } }, { "type": "dialog", "property": { "text": "青岛地区历经沧桑,有着丰富的文化旅游景观,根据景观的空间分布和文化内涵,可分为各具特色的四大区域,即:西部旧城区、东部新区、市区腹地、郊区。到青岛来游览,即可享受宜人的气候和优美的风光。又可在观赏中外文化碰撞交融的结晶中产生深层次的思索和启迪,因而具有很高的旅游美学价值。", "emotion": "happy" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "skill_id": "bd3984bc-f1db-4257-8fff-01b60e07fa40", "id": "f790b04b-dbe4-4918-a241-a16acb104203" }], "meta_process_milliseconds": 76 } } ``` **详细参数说明** |名称 |类型| 说明 |:---|:---|:--- |service| String |服务名称 |answer|String |返回答案