API接口设计说明书

XXAPI接口设计说明书公司2016年11月25日文档管理信息表主题XXapi接口设计说明书版本V0.1内容关键字参考文档创建时间创建人最新发布日期文档变更记录表修改人修改时间修改内容创建【机密】上海莫辩信息科技有限公司1目录文档变更记录表.......................................................................................................................3目录.........................................................................................................................................1引言...........................................................................................................................................1编写目的....................................................1背景........................................................1定义........................................................1参考资料....................................................1综述...........................................................................................................................................2统一的输入输出参数...........................................2必须登录才能访问的接口.......................................2错误返回码列表..............................................3用户接口...................................................................................................................................4用户注册（user/signup）......................................4用户登录（user/signin）......................................5优惠券接口...............................................................................................................................9我的优惠券（coupon/mycoupon）................................9【机密】上海莫辩信息科技有限公司1引言编写目的{说明编写这份用户手册的目的，指出预期的读者。}背景{说明：a．这份用户手册所描述的软件系统的名称；b．该软件项目的任务提出者、开发者、用户（或首批用户）及安装此软件的的计算站中心。}定义{列出本文件中用到的专门术语的定义和外文首字母组词的原词组。}参考资料{列出有用的参考资料，如：a．本项目的经核准的计划任务书或合同、上级机关的批文；b．属于本项目的其它已发表的文件；c．本文件中各处引用的文件、资料、包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。}【机密】上海莫辩信息科技有限公司2综述统一的输入输出参数Request参数名类型是否必须描述languageStringYcn:中文，en:英文，th：泰文uidIntY用户ID.sidStringYSessonId（TOKEN）（不需要登录就能调用的接口、注册接口、登录接口，uid和sid两个参数不需要输入）Response参数名类型是否必须描述succeedIntY0：失败，1：成功error_codeIntN错误码error_descStringN错误消息必须登录才能访问的接口接口名称描述user/signout用户退出user/photoupload照片上传user/changeprofile修改用户资料user/changepassword修改用户密码user/info获取用户信息【机密】上海莫辩信息科技有限公司3错误返回码列表error_codeerror_desc1授权过期500服务器内部错误600账号被锁定10001手机号码不能为空10002密码不能为空10003验证码不能为空10004平台类型不正确10005手机验证码不正确10006手机验证码已失效10007用户类型不正确10008用户名不能为空10009原密码不能为空10010新密码不能为空10011原密码不正确10012经度不能为空10013纬度不能为空10014对象用户ID不能为空【机密】上海莫辩信息科技有限公司4用户接口用户注册（user/signup）接口user/signup描述用户注册验证Session方法GET/POSTRequest参数名类型是否必须描述mobileIntY注册手机号.verify_codeStringY手机验证码passwordStringY密码platformStringY平台类型（ios,android）ResponseExampleRequest{mobile:[phone],verify_code:123456,password:111111,platform:android}参数名类型是否必须描述sidStringYSessonId（TOKEN）uidIntY用户ID【机密】上海莫辩信息科技有限公司5Response1.错误情况{succeed:0,error_code:10006,error_desc:手机验证码已失效}2.正常情况{sid:sess_573d27b370dc7,uid:28,succeed:1}用户登录（user/signin）接口user/signin描述用户登录验证Session方法GET/POSTRequest参数名类型是否必须描述mobileIntN注册手机号.(type=1时必须)usernameStringN用户名(type=2、3、4时必须)passwordStringN密码(type=1时必须)【机密】上海莫辩信息科技有限公司6typeIntY用户类型1：手机号2：QQ3：微信4：微博platformStringY平台类型（ios,android）Response参数名类型是否必须描述sidStringYSessonId（TOKEN）userArrayY用户信息idIntY用户IDuser_groupIntY用户角色1：普通用户2：专车车主nicknameStringY昵称emailStringY邮箱mobileStringY手机号nameStringY姓名usernameStringY用户名genderIntY性别0：男1：女ageIntY年龄birthdayStringY出生日期avatarStringY头像URLjoined_atStringY注册时间Example【机密】上海莫辩信息科技有限公司7Request{type:1,mobile:[phone],password:111111,platform:android}Response1.错误情况{succeed:0,error_code:2003,error_desc:密码错误}2.正常情况{sid:sess_573d285820a42,user:{id:3,user_group:1,nickname:test001,email:[e-mail],mobile:[phone],name:王小二,username:,gender:0,age:26,【机密】上海莫辩信息科技有限公司8birthday:1985-10-10,avatar:/travel/public/uploadFile/avatar/empty.png,joined_at:2016-05-0310:15:53},succeed:1}【机密】上海莫辩信息科技有限公司9优惠券接口我的优惠券（coupon/mycoupon）接口coupon/mycoupon描述我的优惠券验证Session方法GET/POST