# 0508签到系统 **Repository Path**: Tim_PHPer/0508_checkin_system ## Basic Information - **Project Name**: 0508签到系统 - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2019-05-12 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 签到系统接口文档 **1\. 用户注册** ###### 接口功能 > 用户注册 ###### URL > [http://www.api.com/api/index/registe] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | nickname | 是 | string | 姓名 | | phone| 是 | string | 手机 | | card | 是 | string | 身份证 | | openid | 是 | string | 用户的微信openid | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | member_id | int| 用户ID | ###### 接口示例 > 地址：[http://www.api.com/api/index/registe?nickname=Tim&phone=15622193123&card=440682199501122121&openid=123] ``` {"code":1,"msg":"\u6ce8\u518c\u6210\u529f","member_id":6} ``` **2\. 查询用户信息** ###### 接口功能 > 查询用户信息 ###### URL > [http://www.api.com/api/index/getMember] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | openid | 是 | string | 用户的微信openid | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | data| array| 用户信息数组 | | data[id]| int | 用户ID | | data[brand_id]| string | 分支 | | data[role_id]| string | 角色 | | data[card]| string | 身份证号 | | data[nickname] | string | 姓名 | | data[phone]| string | 手机| | data[name] | 是 | string | 微信名 | | data[headimg] | 是 | string | 微信头像 | ###### 接口示例 > 地址：[http://www.api.com/api/index/getMember?openid=123] ``` {"code":1,"msg":"\u67e5\u627e\u6210\u529f","data":{"id":6,"branch_id":"\u987a\u5fb7\u515a\u652f\u90e8","role_id":"\u5357\u4e8c\u515a\u652f\u90e8","card":"440682199501122121","nickname":"Tim","phone":"15622193123"}} ``` **3\. 获取任务** ###### 接口功能 > 用户注册 ###### URL > [http://www.api.com/api/index/getTask] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | type| 是 | string | 类型 1：待完成 2、已完成 3、未完成 | | op_type| 是 | int| 请求类型 1：首页预加载 2、用户选择 | | openid | 是 | string | 用户的微信openid | | page| 否 | int| 页码 默认1 | | limit| 否 | int| 每页显示数 默认10| ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | is_new| int| 是否有新内容（小红点）。 0：没有 1：有| | data| array| 任务信息数组 | | data[][id]| int | 任务ID | | data[][type]| string | 类型 | | data[][title]| string | 任务标题| | data[][end_at]| string | 截止时间 例如2019-05-11 | | data[][points]| int | 积分| | data[][phone]| string | 手机| | data[][is_sign]| int| 是否任务签到审核中 0：否 1：是 | | data[][is_sign_error]| string| 审核中的任务弹框提示内容（is_sign=1时） | | page_info| array| 页数数组 | | page_info[limit]| int | 每页显示数 | | page_info[page_current]| int | 当前页码 | | page_info[page_sum]| int | 总共页数 | ###### 接口示例 > 地址：[http://www.api.com/api/index/getTask?openid=123&type=1&page=1&limit=10] ``` {"code":1,"msg":"\u67e5\u8be2\u6210\u529f","data":[{"id":2,"type":"\u5b63\u5ea6| \u6d3b\u52a8","title":"\u4efb\u52a1\u6d4b\u8bd52","end_at":"2019-05-30","points":12,"create_at":"2019-05-24 18:36:20","is_sign":1,"is_sign_error":"\u60a8\u5df2\u7b7e\u5230\uff0c\u8bf7\u8010\u5fc3\u7b49\u5f85\u5ba1\u6838\uff01"},{"id":6,"type":"\u6d3b\u52a8","title":"3\u6708\u6d3b\u52a8","end_at":"2019-05-30","points":10,"create_at":"2019-05-22 15:50:39","is_sign":0},{"id":7,"type":"\u6708\u5ea6 |\u6d3b\u52a8","title":"\u6d4b\u8bd53","end_at":"2019-05-30","points":12,"create_at":"2019-05-27 11:53:26","is_sign":0}],"page_info":{"limit":"10","page_current":"1","page_sum":1,"count":3},"is_new":0} ``` **4\. 获取排名** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/api/index/getRank] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | type| 是 | string | 类型 1：全公司 2、支部中排名 3、角色中排名 4、所在支部的支部排名 | | openid | 是 | string | 用户的微信openid | | page| 否 | int| 页码 默认1 | | limit| 否 | int| 每页显示数 默认10| ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | data| array| 任务信息数组 | | data[][id]| int | 员工ID | | data[][type]| string | 类型 | | data[][sort]| int | 排名| | data[][points]| int | 积分| | data[][headimg]| int | 微信头像| | page_info| array| 页数数组 | | page_info[limit]| int | 每页显示数 | | page_info[page_current]| int | 当前页码 | | page_info[page_sum]| int | 总共页数 | ###### 接口示例 > 地址：[http://www.api.com/api/index/getRank?openid=123&type=1&page=1&limit=10] ``` {"code":1,"msg":"\u67e5\u8be2\u6210\u529f","data":[{"id":10,"nickname":"Tim4","points":5,"sort":1},{"id":7,"nickname":"Tim1","points":3,"sort":2},{"id":6,"nickname":"Tim","points":2,"sort":3},{"id":8,"nickname":"Tim2","points":2,"sort":4},{"id":9,"nickname":"Tim4","points":1,"sort":5}],"page_info":{"limit":"10","page_current":"1","page_sum":1}} ``` **5\. 获取用户openid** ###### 接口功能 > 获取用户openid ###### URL > [http://www.api.com/api/index/getOpenid] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | code| true | string | 用户授权后获得的code | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | data| array | 用户信息 | ###### 接口示例 > 地址：[http://www.api.com/api/index/saveIntentionRecord] ``` 未知 ``` **6\. 用户任务签到** ###### 接口功能 > 用户任务签到 ###### URL > [http://www.api.com/api/index/signUp] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | title| true | string | 签到标题 | | content| true | string | 签到内容 | | task_id| true | int| 任务id | | openid| true | string | 用户OPENID | | name | 是 | string | 微信名 | | headimg | 是 | string | 微信头像 | | images| true | array| 图片数组 | | images[x]| true | string| base64加密后的图片文件 | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/api/index/signUp] ``` {"code":1,"msg":"\u67e5\u8be2\u6210\u529f" ```