API接口设计说明书书书.doc
.wd.XXAPI接口设计说明书文档管理信息表主题XX api接口设计说明书 版本V0.1内容关键字参考文档创立时间创立人最新发布日期文档变更记录表修改人修改时间修改内容创立目 录文档变更记录表3目录1引言1编写目的1背景1定义1参考资料1综述2统一的输入输出参数2必须登录才能访问的接口2错误返回码列表3用户接口4用户注册user/signup4用户登录user/signin5优惠券接口9我的优惠券coupon/mycoupon9引言编写目的说明编写这份用户手册的目的，指出预期的读者。背景说明：a这份用户手册所描述的软件系统的名称；b该软件工程的任务提出者、开发者、用户或首批用户及安装此软件的的计算站中心。定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。参考资料列出有用的参考资料，如：a本工程的经核准的方案任务书或合同、上级机关的批文；b属于本工程的其它已发表的文件；c本文件中各处引用的文件、资料、包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。综述统一的输入输出参数Request参数名类型是否必须描述languageStringYcn:中文，en:英文，th：泰文uidIntY用户ID. sidStringYSessonIdTOKEN不需要登录就能调用的接口、注册接口、登录接口，uid和sid两个参数不需要输入Response参数名类型是否必须描述succeedIntY0：失败，1：成功error_codeIntN错误码error_descStringN错误消息必须登录才能访问的接口接口名称描述user/signout用户退出user/photoupload照片上传user/changeprofile修改用户资料user/changepassword修改用户密码user/info获取用户信息错误返回码列表error_codeerror_desc1授权过期500服务器内部错误600账号被锁定10001手机号码不能为空10002密码不能为空10003验证码不能为空10004平台类型不正确10005手机验证码不正确10006手机验证码已失效10007用户类型不正确10008用户名不能为空10009原密码不能为空10010新密码不能为空10011原密码不正确10012经度不能为空10013纬度不能为空10014对象用户ID不能为空用户接口用户注册user/signup接口user/signup描述用户注册验证Session方法GET/POSTRequest参数名类型是否必须描述mobileIntY注册手机号. verify_codeStringY手机验证码passwordStringY密码platformStringY平台类型ios,androidResponse参数名类型是否必须描述sidStringYSessonIdTOKENuidIntY用户IDExampleRequest "mobile": "15866667777", "verify_code": "123456", "password": "111111", "platform": "android"Response1.错误情况 "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时必须)typeIntY用户类型1：手机号2：QQ3：微信4：微博platformStringY平台类型ios,androidResponse参数名类型是否必须描述sidStringYSessonIdTOKENuserArrayY用户信息idIntY用户IDuser_groupIntY用户角色1：普通用户2：专车车主nicknameStringY昵称emailStringY邮箱mobileStringY手机号nameStringY姓名usernameStringY用户名genderIntY性别0：男1：女ageIntY年龄birthdayStringY出生日期avatarStringY头像URLjoined_atStringY注册时间ExampleRequest "type": "1", "mobile": "15866668888", "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": "xiaoxiao163 ", "mobile": "15866668888", "name": "王小二","username" : "", "gender": 0, "age": 26,"birthday ":"1985-10-10", "avatar": "/travel/public/uploadFile/avatar/empty.png", "joined_at": "2016-05-03 10:15:53" , "succeed": 1
