API接入使用文档.pdf

API接入使用文档 Release Date 2016-04-29 目录 1API 简介2 2 获取APIKEY2 3 接口地址 3 4 请求方式 3 5 请求参数 3 6 返回数据格式5 6.1 文字类6 6.2 链接类6 6.3 新闻类7 6.4 列车类9 6.5 航班类 10 6.6 菜谱类 11 6.7 儿歌类 13 6.8 诗词类 14 7 返回异常码 15 7.1 异常返回示例15 7.2 异常码说明15 8 数据加密 16 8.1 用户须知16 8.2 调用说明16 8.2.1 请求地址16 8.2.2 请求方式16 8.2.3 编码方式16 8.3 加密算法规则16 8.3.1 参数说明16 8.3.2 生成密钥17 8.3.3 执行AES 加密17 8.3.4 封装请求图灵API 的json 参数 17 1 北京光年无限科技有限公司 1API 简介 图灵机器人 API是在人工智能的核心能力 （包括语义理解、智能问答、场景交互、知 识管理等 ）的基础上 ，为广大开发者、合作伙伴和企业提供的一系列基于云计算和大数据平 台的在线服务和开发接口。 开发者可以利用图灵机器人的API创建各种在线服务 ，灵活定义机器人的属性、编辑 机器人的智能问答内容 ，打造个人专属智能交互机器人 ，也支持多渠道 （微信公众平台、 QQ聊天 ）的快速接入。 2 获取APIKEY （1 ）登入图灵机器人官方网站 http/// ，点击右上角 “注册”按 钮进行注册并激活账号 ，如下图所示 ： 2 北京光年无限科技有限公司 （2 ）登入图灵账号 ，进入个人中心板块 ，在 “机器人接入”页面即可看到 API KEY ， 如下图所示 ： 3 接口地址 http///openapi/api 4 请求方式 HTTP POST 注 ：若之前使用 get 请求方式 ，仍能继续使用,日后将对该请求方式不再进行更新及维 护工作 ，建议采用 post 请求方式。 5 请求参数 请求参数格式为json 请求示例 ： { “key” “APIKEY”, “info” “今天天气怎么样” ， 3 北京光年无限科技有限公司 “loc”：“北京市中关村”， “userid”：“123456” } 参数 是否必须 长度 示例 说明 1ca8089********736b8ce4 注册之后在机器人 key 必须 32 1591426(32位) 接入页面获得 （参