1、API接口设计说明书XXAPI接口设计说明书公司2016年11月25日文档管理信息表主题XX api接口设计说明书版本内容关键字参考文档创建时间创建人最新发布日期修改人修改时间修改内容创建编写目的 说明编写这份用户手册的目的,指出预期的读者。 背景说明:a 这份用户手册所描述的软件系统的名称;b 该软件项目的任务提出者、开发者、用户(或首批用户)及安装此软件的的计算站中 心。定义 列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 参考资料列出有用的参考资料,如:a 本项目的经核准的计划任务书或合同、上级机关的批文;b 属于本项目的其它已发表的文件;c 本文件中各处引用的文件、资料、包
2、括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、 发表日期和出版单位,说明能够得到这些文件资料 的来源。 统一的输入输出参数RequestIan guageStri ngYcn:中文,en:英文,th :泰文uidIntY用户ID.sidStri ngYSessonld( TOKEN(不需要登录就能调用的接口、注册接口、登录接口, uid和sid两个参数不需要输入)ResponsesucceedIntY0:失败,1成功error_codeIntN错误码error_descStr ingN错误消息必须登录才能访问的接口接口名称描述user/sig nout用户退出user/photo
3、upload照片上传user/cha ngeprofile修改用户资料user/cha ngepassword修改用户密码user/ info获取用户信息错误返回码列表error_codeerror_desc1授权过期500服务器内部错误600账号被锁疋10001手机号码不能为空10002密码不能为空10003验证码不能为空10004平台类型不正确10005手机验证码不正确10006手机验证码已失效10007用户类型不正确10008用户名不能为空10009原密码不能为空10010新密码不能为空10011原密码不正确10012经度不能为空10013纬度不能为空10014对象用户ID不能为空sid
4、 String Y Sessonld (TOKENExampleRequest用户注册(user/signup )接口user/sig nup描述用户注册验证Sessi on方法GET/POSTRequestmobileIntY注册手机号.verify_codeStri ngY手机验证码passwordStri ngY密码platformStri ngY平台类型(ios,android )Responseverify_code: 123456,password: 111111,platform: a ndroidResponse1.错误情况succeed: 0,error_code: 1000
5、6,error_desc: 手机验证码已失效2.正常情况sid: sess_573d27b370dc7,uid: 28,succeed: 1用户登录(user/signin )接口user/sig nin描述用户登录验证Sessi on方法GET/POSTRequestmobileIntN注册手机号.(type=1 时必须)user nameStri ngN用户名(type=2、3、4时必须)passwordStri ngN密码(type=1时必须)用户类型1 :手机号typeIntY2: QQ3:微信4:微博platformStri ngY平台类型(ios,android )Response
6、idIntY用户ID用户角色user_groupIntY1:普通用户2:专车车主nickn ameStr ingY昵称emailStr ingY邮箱mobileStr ingY手机号n ameStr ingY姓名user nameStr ingY用户名性别genderIntY0:男1 :女ageIntY年龄birthdayStr ingY出生日期avatarStr ingY头像URLjoin ed_atStr ingY注册时间ExampleRequesttype: 1,password: 111111,platform: a ndroidResponse1.错误情况succeed: 0,err
7、or_code: 2003,error_desc: 密码错误 2.正常情况sid: sess_573d285820a42,user: id: 3,user_group: 1,n ick name: test001,name: 王小二,user name:,gender: 0,age: 26,birthday :1985-10-10,avatar: /travel/public/uploadFile/avatar/,joi ned_at: 2016-05-03 10:15:53,succeed: 1我的优惠券(coup on/mycoupon )接口coupon / mycoupon描述我的优惠券验证Sessi on方法GET/POST