接口设计规范V参考.docx

1、接口设计规范V参考服务端与手机平台接口协议BespRout2014年11月文档修改/审批记录版本号修改人/审批人修改/审批日期修改内容备注V1.0林成民2014-11-12创建V1.0林成民2014-11-19添加商家和品牌相关等的接口V1.0林成民2014-11-21添加Ordering相关等接口V1.0吴秋锦2014-11-24更换前缀+coupon接口V1.0林成民2015-4-28修改 4.61、4.64、4.47、4.49、 4.50接口，并且添加4.86接口V1.0林成民2015-5-18修改 4.66接口的参数说明，新增 4.87、 4.88、4.89、 4.90 接口V1.0林

2、成民2015-5-27修改4.90接口（添加相关的响应参数），添加新接口4.91V1.0林成民2015-8-06修改4.64，添加是否显示同步用户信息按钮V1.0林成民2015-8-12修改 4.49、4.50 接口V1.0林成民2015-12-14修改4.3、 4.68接口1. 概述 42. 涉及接口 43. 接口总体要求 43.1. 系统间接口的原则 . 43.2. 处理流程 . 43.3. 接口实现方式 . 54. XXX务端接口 54.1. XX模块-根据XX下载相关的配置文件 542 XX模块-生成指定XX的文件配置 64.3. APP启动-初使化参数 75. 附件 85.1. 备注

3、说明 81. 概述本文档提供接口给手机端 使用，为手机端提供业务平台数据2. 涉及接口本文档涉及的外围系统接口包括：无3. 接口总体要求3.1. 系统间接口的原则接口设计遵循如下原则：安全可靠性原则：系统应提供良好的安全性和可靠性策略，支持多种安全而 可靠的技术手段，制定严格的安全可靠的管理措施； 开放性原则：提供开放式标准接口，提供与其它系统的互联互通； 灵活性原则：提供灵活的接口设计，便于接口的变动。可扩展性原则：支持新业务的扩展以及接口容量与接口性能的提高； 可管理性原则：提供良好的管理机制，保证在运行过程中提供给管理员方便 的管理方式以处理各种情况；统一性原则：应当保证系统的接口方式、

4、接口形式、使用的协议等标准、统 一。3.2. 处理流程接口处理流程http请求htt p请求iphone手机33接口实现方式手机APP应用 与服务端采用基于HTTP勺REST协议完成，数据传输默认为JSON请求消息JSON（详细见下面各列表）应答消息json （JSON 格式）接口协议http （ rest 协议）接口实现者Mascar_qis 服务端主要使用者手机 APP（ an droid & ipho ne）4. XXX服务端接口测试地址前缀：http:/192.168.3.208:8088/xxx/xxx4.1. XX模块-根据XX下载相关的配置文件接口名称下载相关的配置文件接口描述根

5、据厂商ID下载相关的配置文件测试地址前缀 +/ file/dow nload/storeld?toke n =token参数详见配置请求方式GET正式地址宀待定参数请求体参数参数含义类型长度必填说明patform平台Stri ng20必填值为iphone 或者an droid响应体无42 XX模块-生成指定XX的文件配置接口名称生成指定商家的文件配置接口描述根据厂商ID，生成指定商家的文件配置测试地址前缀 +/file/ge nerate/storeld?toke n =token参数详见配置请求方式GET正式地址z-k宀待定参数请求体无响应体参数参数含义数据类型说明respCode标识是否操

6、作成功Stri ng0成功1失败respDesc当标识respCode为1时候显示错误信息Stri ng43 APP启动-初使化参数接口名称初使化参数接口接口描述初使化参数接口测试地址前缀 +/bra nds/param/list?toke n =token参数详见配置请求方式GET正式地址z-k宀待定请求参数无响应体参数参数含义数据类型说明respCode标识是否操作成功Stri ng0成功1失败respDesc当标识respCode为1时候显示错误信息Stri ngshareFacebookUrlfb分享的地址Stri ngshareFacebookKeyStri ngshareFaceb

7、ookSecre tStri ngshareFacebook Infofb分享的内容Stri ngshareTwitterUrltw分享的地址Stri ngshareTwitterKeyStri ngshareTwitterSecretStri ngshareTwitterI nfotw分享的内容Stri ngshareEmailStri ngshareEmailTitleemail分享的标题Stri ngmaxNumOfFamilyMemerb最多允许加入的家庭成员的个数Stri ngguid in gTextOfHBCHBC引导文字Stri nghelpTextOfHBCHBC帮助文字St

8、ri ngpayType支付类型Stri ng1-Authorize .n et,2-Trus tCommerce,3-ProPay注：以上所有内容需先Base64解，再DES解才可得到定义的内容5. 附件5.1.备注说明token算法生成说明：加密方式：手机与服务端各持有密钥 Key,密钥暂定为XXXXtoken= Base64 ( “ time=&num=&accessToken=&version=&appld=&brandld=&platform=& pho neUUID= ”)Key值说明time当前时间的long值num5位数字和字母的随机字符串accessToke nDes(Key

9、, “ time _ num”)appId后台分配的用户Id调用注册或者没有id直接使用initversi onApp当前版本号bra ndld后台分配的品牌Idplatform平台类型：iph on e/iph on eLite an droid/a ndroidLitepho neUUlD安装软件后唯一标识 64UUID开发过程中，可以先传一个固定token :XXX备注:respCode标识是否操作成功Stri ng0成功1失败2用户其他手机登录3用户登录 后，被锁。respDesc当标识respCode为1时候显示错误 信息Stri ng如果2或者3需要强行弹框，点击后直接退出到登录界面1视业务逻辑，选择是否强框