一、CP管理 · API接口

## 1、新增库 bc_cps ``` CREATE TABLE `bc_cps` ( `id` int(11) NOT NULL AUTO_INCREMENT, `user_id` int(11) DEFAULT NULL COMMENT '发起者的ID', `user_phone` varchar(13) DEFAULT NULL COMMENT '发起者电话', `cp_id` int(11) DEFAULT NULL COMMENT '对象的ID', `cp__phone` int(11) DEFAULT NULL COMMENT '对象的ID', `states` tinyint(2) DEFAULT NULL COMMENT '状态 0：待同意 1组建成功 2：组建失败（对方拒绝）3：对方已有其她CP', `add_time` int(11) DEFAULT NULL COMMENT '发起时间', `update_time` int(11) DEFAULT NULL COMMENT '对方同意时间', PRIMARY KEY (`id`) ) ENGINE=MyISAM DEFAULT CHARSET=utf8; ``` bc_cp_tasks ``` CREATE TABLE `bc_cp_tasks` ( `id` int(11) NOT NULL AUTO_INCREMENT, `cp_id` int(11) DEFAULT NULL COMMENT 'CP表的ID', `task_id` int(11) DEFAULT NULL COMMENT '任务ID', `task_content` tinytext, `task_title` varchar(120) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL COMMENT '第几个任务例如任务一', `user_id` int(11) DEFAULT NULL, `user_time` int(11) DEFAULT NULL COMMENT '用户完成时间', `user_img` varchar(255) DEFAULT NULL COMMENT '用户上传的图片', `user_content` text COMMENT '用户的描述', `cp_time` int(11) DEFAULT NULL COMMENT '对方完成时间', `cp_img` varchar(255) DEFAULT NULL COMMENT '对方上传的图片', `cp_content` text COMMENT '对方的描述', `states` tinyint(2) DEFAULT '0' COMMENT '任务状态 1为结束', `add_time` int(11) DEFAULT NULL COMMENT '任务创建时间', PRIMARY KEY (`id`) ) ENGINE=MyISAM AUTO_INCREMENT=2 DEFAULT CHARSET=utf8 COMMENT='Cp 任务表'; ``` bc_tasks ``` CREATE TABLE `bc_tasks` ( `id` int(11) NOT NULL AUTO_INCREMENT, `title` varchar(255) DEFAULT NULL, `content` text, `add_time` int(11) DEFAULT NULL, `sort` int(11) DEFAULT NULL, `states` tinyint(2) DEFAULT '0', PRIMARY KEY (`id`) ) ENGINE=MyISAM DEFAULT CHARSET=utf8 COMMENT='任务表'; ``` ## 1、CP建立 > CP建立请求地址：[ https://你的域名/api/cp/add ] 请求方法：post 请求数据： | 字段 |值 |备注| | --- | --- |---| | cp_id | 数字 |对象ID| 返回数据：定义10001 为错误 200为成功 ``` { "success": true, "code": "200", "msg": "数据保存成功！", "obj": { "data": { "user_id": "申请者ID", "cp_id": "对象ID", "user_phone": 申请者电话, "cp_phone": 对象电话, "states": 0, "add_time": 1635271440 } } } ``` ## 2、我邀请的CP/ 邀请我的CP > 我邀请的CP/ 邀请我的CP 请求地址：[ https://你的域名/api/cp/user_data ] 请求方法：get 请求数据： | 字段 |值 |备注| | --- | --- |---| | category | 数字 |定义的类别不传值或0时为我邀请的CP，1或其它值为邀请我的CP| 返回数据：定义10001 为错误 200为成功 ``` { "success": true, "code": "200", "msg": "数据获取成功！", "obj": { "data": { ...... } } } ``` ## 3、CP的操作 > Cp的同意拒绝等请求地址：[ https://你的域名/api/cp/user_operation ] 请求方法：get 请求数据： | 字段 |值 |备注| | --- | --- |---| | id| 数字 |当前数据的ID值| |states|数值（前端传递1为组建成功传递2为拒绝）|状态 0：待同意 1组建成功 2：组建失败（对方拒绝）3：对方已有其她CP| 返回数据：定义10001 为错误 200为成功 ``` { "success": true, "code": "200", "msg": "数据获取成功！", "obj": { "data": { ...... } } } ``` ## 4、获取我的Cp > 获取我的Cp 请求地址：[ https://你的域名/api/cp/find ] 请求方法：get 请求数据：无返回数据：定义10001 为错误 200为成功 ``` { "success": true, "code": "200", "msg": "数据获取成功", "obj": { "user_data": null, //我的信息 "cp_data": null, //对方信息 "cp_task": null //当前CP任务 "task_sates": 0 //此值为0 的时候证明没有 Cp任务 } } ``` ## 5、我的任务 > 获取我的Cp任务请求地址：[ https://你的域名/api/cp/task_data ] 请求方法：get 请求数据：无返回数据：定义10001 为错误 200为成功 ``` { "success": true, "code": "200", "msg": "数据获取成功", "obj": [ { "id": 1, "cp_id": 1, "task_id": null,//任务ID "task_content": null,//任务描述 "task_title": null, // 任务一 "add_time": "2021-10-27 01:40:47", "states": 0 } ] } ``` ## 6、Cp任务详情 > 获取单条Cp任务详情请求地址：[ https://你的域名/api/cp/task_data ] 请求方法：get 请求数据：id =x 任务ID 返回数据：定义10001 为错误 200为成功 ``` { "success": true, "code": "200", "msg": "数据获取成功", "obj": { "user": { //当前用户的信息 "photo": "https://njca.stwxs.com/uploads/original/20211026/3d406751bf94483311956e549e779d7d.png", "nickname": "小打哈哈", "district_cn": "江苏.南京.江宁区", "gender": 1 }, "cp": {//对方的信息 "photo": "https://njca.stwxs.com/uploads/original/20211025/a2d53acb01e0ec79054e33060c67b2d5.png", "nickname": "魔掌如来", "district_cn": "江苏.南京.栖霞区", "gender": 1 }, "user_data": { //当前用户的任务情况 "user_time": "", // 提交时间 "img": "", //图片 "content": "" //内容 }, "cp_data": {//对方完成情况 "user_time": "", // 提交时间 "img": "", //图片 "content": "" //内容 }, "task": { //任务描述 "id": 1, "cp_id": 21, "task_id": null, "task_content": null, "task_title": null, "user_id": null, "states": 0, //0 为进行中 1为完成 "add_time": "2021-10-27 01:40" } } } ``` ## 7、Cp任务提交 > 提交完成的CP任务请求地址：[ https://你的域名/api/cp/task_save ] 请求方法post 请求数据： | 字段 |值 |备注| | --- | --- |---| | id | 数字 |任务ID| | content | 内容 |内容| | img | 图片路径 |图片路径| 返回数据：定义10001 为错误 200为成功 ``` { "success": true, "code": "200", "msg": "数据保存成功！", "obj": { "data": { .................... } } } ```