API接口设计说明书

1、XXAPI接口设计说明书公司2016 年11 月25日文档管理信息表主题XX api 接口设计说明书版本内容关键字参考文档创建时间创建人最新发布日期文档变更记录表修改人修改时间修改内容创建目 录文档变更记录表 .目 录 . .引言 . .编写目的 .背景 .定义 .参考资料 .综述 . .统一的输入输出参数.必须登录才能访问的接口.错误返回码列表.用户接口 . .用户注册（ user/signup） .用户登录（ user/signin） .优惠券接口 .我的优惠券（ coupon/mycoupon ） .引言编写目的 说明编写这份用户手册的目的，指出预期的读者。背景 说明：a 这份用户手册所

2、描述的软件系统的名称；b 该软件项目的任务提出者、开发者、用户（或首批用户）及安装此软件的的计算站中心。 定义 列出本文件中用到的专门术语的定义和外文首字母组词的原词组。参考资料 列出有用的参考资料，如：a 本项目的经核准的计划任务书或合同、上级机关的批文；b 属于本项目的其它已发表的文件；c 本文件中各处引用的文件、资料、包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。 综述统一的输入输出参数RequestlanguageStringYcn: 中文， en: 英文， th ：泰文uidIntY用户 ID.sidStringYS

3、essonId （TOKEN）（不需要登录就能调用的接口、注册接口、登录接口，uid 和 sid 两个参数不需要输入）ResponsesucceedIntY0：失败， 1：成功error_codeIntN错误码error_descStringN错误消息必须登录才能访问的接口接口名称描述user/signout用户退出user/photoupload照片上传user/changeprofile修改用户资料user/changepassword修改用户密码user/info获取用户信息错误返回码列表error_codeerror_desc1授权过期500服务器内部错误600账号被锁定10001手机

4、号码不能为空10002密码不能为空10003验证码不能为空10004平台类型不正确10005手机验证码不正确10006手机验证码已失效10007用户类型不正确10008用户名不能为空10009原密码不能为空10010新密码不能为空10011原密码不正确10012经度不能为空10013纬度不能为空10014对象用户 ID 不能为空用户接口用户注册（ user/signup）接口user/signup描述用户注册验证Session方法GET/POSTRequestmobileIntY注册手机号 .verify_codeStringY手机验证码passwordStringY密码platformStr

5、ingY平台类型（ ios,android）ResponsesidStringYSessonId （ TOKEN）uidIntY用户 IDExampleRequest"verify_code": "123456","password": "111111","platform": "android"Response1. 错误情况"succeed": 0,"error_code": 10006,"error_desc":

6、 "手机验证码已失效"2. 正常情况"sid": "sess_573d27b370dc7","uid": "28","succeed": 1用户登录（ user/signin）接口user/signin描述用户登录验证Session方法GET/POSTRequestmobileIntN注册手机号 . (type=1时必须 )usernameStringN用户名 (type=2 、 3、4 时必须 )passwordStringN密码 (type=1时必须 )用户类型1：手机号

7、typeIntY2： QQ3：微信4：微博platformStringY平台类型（ ios,android）ResponsesidStringYSessonId （ TOKEN）userArrayY用户信息idIntY用户 ID用户角色user_groupIntY1：普通用户2：专车车主nicknameStringY昵称emailStringY邮箱mobileStringY手机号nameStringY姓名usernameStringY用户名性别genderIntY0：男1：女ageIntY年龄birthdayStringY出生日期avatarStringY头像 URLjoined_atStri

8、ngY注册时间ExampleRequest"type": "1","password": "111111","platform": "android"Response1. 错误情况"succeed": 0,"error_code": 2003,"error_desc": "密码错误 "2. 正常情况"sid": "sess_573d285820a42",&q

9、uot;user": "id": 3,"user_group": 1,"nickname": "test001","name": "王小二 ","username" : "","gender": 0,"age": 26,"birthday ":"1985-10-10","avatar": "/travel/public/uploadFile/avatar/","jo