天翼空间API之书名查询接口规范_v1.0.doc

《应用工厂书名查询AP接口规范》 中国电信四川有限责任公司 中兴通讯有限责任公司 2010年月 版本 修改说明 作者 V1.0 初稿 王平 V1.0 修订 贾铸 文档变更记录 目录 1. 用户场景描述 1 1.1 书名查询场景描述 1 1.2 流程 1 2. 接口详细 2 2.1 书名查询业务 2 2.1.1 书名查询请求 2 3. 示例： 5 3.1.1 Md5加密： 5 3.1.2 3DES加密： 5 4. 备注 8 用户场景描述 书名查询场景描述 用户在AP提供的书名查询页面输入要查询的书名和分类（数据组织格式为c=01kwd=java，01是书籍的分类，Java要查询的书名的关键词），点击查询。 AP组织相关数据，向应用工厂发起查询请求。 应用工厂将查询结果返回给AP,AP将数据展示给用户。 流程 接口详细 书名查询业务 书名查询请求 接口名称 查询请求 接口描述 应用请求应用工厂的书名比价业务进行书名比价 接口协议 http请求 访问地址 3:8080/udt-see/StartServiceServlet 接口方向 应用请求-能力开放平台 名称 必填 类型 描述 APID Y String 应用工厂为AP分配的ID值（000000xx） Key Y String 安全标识(3DES加密) bookName Y String 书名 productID Y String 能力ID,默认为空 TimeStamp Y String 时间戳（格式：YYYYMMDDHHMMSS） 时间戳的格式下同 修改key的加密方式为3DES加密： Key=3DES(TimeStamp+APID) 例如： 明文：201007202382300000001 密钥：34-2jfapjsdofjasdf 密文：asdjpfaosjdq=-34nnweiorj093492 以下请求接口均为3DES加密 请求参数格式为json，如： {serviceID:00000520101007, params:{APID:应用工厂分配, Key:3DES加密(TimeStamp+APID), bookName: java, TimeStamp:”20101007153530”; productID:00000 }}。 应用工厂返回给客户 名称 必填 类型 描述 SessionID Y String 唯一标识本次会话 Result Y String 101—表示没有输入查询地址； 102—表示请求鉴权失败； 103—表示查询书籍信息失败； 100—表示查询成功。 BookInfo Y String 查询结果 备注：返回数据类型为json， 如： response：{returnCode:UDT-0001,returnParams:{Result:100,SessionID:201010081450388456,BookInfo:/26/251_b.jpg,轻量级font?color=redJava\/font?EE企业应用实战\u2015\u2015Struts?2+Spring+Hibernate整合开发,李刚,电子工业出版社,2008年11月,2063988,￥62.30;/4/24/9317290-1_b.jpg,font?color=redJava\/font编程思想(第4版)(计算机科学丛书),(美)埃克尔,机械工业出版社,2007年06月,1799279,￥72.40;/69/321_b.jpg,font?color=redJava\/font核心技术:卷Ⅰ基础知识(SUN公司核心技术丛书),(美)昊斯特曼,机械工业出版社,2008年06月,1983625,￥69.60;/87/23/9211839-1_b.jpg,JavaScript?高级程序设计\u2015\u2015图灵程序设计丛书,扎卡斯,人民邮电出版社,2006年11月,1533220,￥44.20;:80/images/I/510548-Li3L._AA190_.jpg,Head?First?font?color=redJava\/font(中文版)(第2版)(涵盖Java5.0),(美)塞若,中国电力,2007年01月,1737491,￥63.00;/58/111_b.jpg,JavaScript权威指南(第五版),(美)费拉纳提,机械工业出版社,2007年08月,1836697,￥75.20;/images/I/51wg4Rb%2BOrL._SL500_AA190_.jpg,疯狂font?color=redJava\/font讲义