一、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": { .................... } } } ```