# 用户注册api接口 ## 接口文档 ## 1.端点设计 | 接口名称 |端点 |请求方法 | 说明 | | --- | --- | --- | --- | | 用户注册 |http://api.daiban.com/users | post |用户注册 | ## 2.参数 | 参数名称 |是否必填 |类型 | 说明 | | --- | --- | --- | --- | | username|是 | string |用户名(手机号)| | password|是 | string |密码| | repassword|是 | string |密码| | code|是 | string |手机验证码| | timestamp|是 | int|时间戳| ## 3.header 如果是APP项目 需要传递必要的信息 建议放到header传递 | 参数名称 |是否必填 |类型 | 说明 | | --- | --- | --- | --- | | sign|是 | int|签名| ## 4.响应 > 接口无论是否请求成功或者失败，都需要给请求方有响应数据返回。只有这样才可以给请求方更好的体验，也方便接口调试。在这里我们统一用JSON格式的数据返回。返回的数据结构需要根据项目的需求来定。 #### 响应数据如下： 响应头 ``` HTTP/1.1 200 OK Content-Type:application/json ``` 返回数据 ``` { message:"注册成功", data:{}, errorcode:0 } ``` ## 5.错误码 项目错误码对照表 | 项目错误码 | 说明 | | --- | --- | | 60000|用户名格式不正确| | 60001|密码不正确| | 60002|验证码错误| | 60003|请求超时| | 60004|未知错误| | 60005|时间戳不正确| | 60006|参数错误| | 60007|签名错误| | 60008|参数获取失败| 项目使用HTTP状态码 | 项目状态码| 说明 | | --- | --- | | 200|服务器成功处理请求| | 201|服务器成功创建资源| | 400|错误请求服务器不理解请求的语法| | 401|未授权请求，要求身份验证| | 403|服务器禁止，拒绝请求| | 404|服务器找不到请求的网页| | 500|服务器内部错误服务器遇到错误，无法完成请求| ## 6.开发流程 1.创建Users 控制器controller //继承Common控制器 提供访问接口 接受和返回数据 与数据库表对应 名字一致 2.创建Common 控制器controller //继承基础控制器 初始化业务验证 验证签名 定义返回数据json类型 3.创建User 验证类文件 //继承BaseValidate类 Validate 验证字段 4.创建BaseValidate 验证类文件 //继承基础验证类 获取客户端请求数据 5.创建User 模型model //将数据写入数据库 名称不一致 须制定表名