接口管理控制器（V4.0.0版本新增）

豆信4.0.0版本开始支持插件Api控制器，用于为小程序开发提供接口。在插件的Controller目录下新增ApiController，继承Mp模块的ApiBase控制器，即可方便的实现小程序数据交互接口。如在Demo插件的ApiController中定义了一个getDataList()接口，则可以通过路由：/addon/Demo/api/getDataList/mpid/2 进行请求操作。

注意：接口请求必须带上mpid参数，用于标识请求对接的是哪个账号（小程序mpid或公众号mpid），否则接口请求将会被拒绝。

ApiBase控制器封装了以下方法用于快速的实现接口交互逻辑。

  1. checkLogin();            // 如果接口需要限制小程序端用户登录后方可调用，则在接口方法开始处调用此方法。
  2. login();                // 小程序用户登录接口
  3. isLogin();                // 用于检测小程序端用户是否已登录
  4. updateProfile();        // 用于更新小程序用户资料
  5. getSettings();            // 用于获取插件配置
  6. response();                // 用户返回接口响应数据
  7. responseOk();            // 请求成功响应，响应码为：0
  8. responseFail();            // 请求失败响应，响应码为：1001

插件Api控制器继承ApiBase控制器后，可以有两种方式调用上述封装的接口，比如Demo插件需要获取配置信息时，可以通过下面两种方式请求接口：/addon/Demo/api/getSettings/mpid/1或者/Mp/ApiBase/getSettings/mpid/1

我们推荐使用第一种基于插件的Api调用方式。

下面是Demo插件的Api控制器完整示例：

  1. <?php
  3. /**
  4.  * Demo插件Api控制器
  5.  * @author 艾逗笔<http://idoubi.cc>
  6.  */
  7. namespace Addons\Demo\Controller;
  8. use Mp\Controller\ApiBaseController;
  10. class ApiController extends ApiBaseController {
  12.     public $model;
  14.     public function __construct() {
  15.         parent::__construct();
  16.         $this->model = M('demo_diary');
  17.     }
  19.     // 新增日记
  20.     public function addDiary() {
  21.         $this->checkLogin();        // 检测用户是否登录
  22.         $post = I('post.');
  23.         if (empty($post['title']) || empty($post['content'])) {
  24.             $this->response(1001, '提交数据不完整');
  25.         }
  26.         $post['openid'] = $this->openid;
  27.         $post['mpid'] = $this->mpid;
  28.         $post['created_at'] = time();
  29.         $id = $this->model->add($post);
  30.         if ($id) {
  31.             $this->response(0, '提交反馈成功');
  32.         } else {
  33.             $this->response(1001, '提交反馈失败');
  34.         }
  35.     }
  37.     // 获取日记列表
  38.     public function getDiaryList() {
  39.         $this->checkLogin();
  40.         $data = $this->model->where([
  41.             'mpid' => $this->mpid,
  42.             'openid' => $this->openid,
  43.             'status' => 1
  44.         ])->field('id,title,content,created_at')->order('created_at desc')->select();
  45.         foreach ($data as &$v) {
  46.             $v['created_at_format'] = date('Y-m-d H:i:s', $v['created_at']);
  47.         }
  48.         $this->response(0, '获取成功', $data);
  49.     }
  51.     // 修改日记
  52.     public function editDiary() {
  53.         $this->checkLogin();
  54.         $post = I('post.');
  55.         if (empty($post['id']) || empty($post['title']) || empty($post['content'])) {
  56.             $this->response(1001, '提交数据不完整');
  57.         }
  58.         $id = $post['id'];
  59.         $data = $this->model->where([
  60.             'mpid' => $this->mpid,
  61.             'openid' => $this->openid,
  62.             'status' => 1
  63.         ])->find($id);
  64.         if (empty($data)) {
  65.             $this->response(1001, '要修改的数据不存在');
  66.         }
  68.         $res = $this->model->where([
  69.             'id' => $id
  70.         ])->save([
  71.             'title' => $post['title'],
  72.             'content' => $post['content'],
  73.             'updated_at' => time()
  74.         ]);
  75.         if ($res === false) {
  76.             $this->response(1001, '修改失败');
  77.         }
  78.         $this->response(0, '修改成功');
  79.     }
  81.     // 删除日记
  82.     public function deleteDiary() {
  83.         $this->checkLogin();
  84.         $id = I('post.id');
  85.         $data = $this->model->where([
  86.             'mpid' => $this->mpid,
  87.             'openid' => $this->openid,
  88.             'status' => 1
  89.         ])->find($id);
  90.         if (empty($data)) {
  91.             $this->response(1001, '要删除的数据不存在');
  92.         }
  94.         // 软删除
  95.         $res = $this->model->where([
  96.             'id' => $id
  97.         ])->save([
  98.             'status' => -1,
  99.             'deleted_at' => time()
  100.         ]);
  101.         if ($res === false) {
  102.             $this->response(1001, '删除失败');
  103.         }
  104.         $this->response(0, '删除成功');
  105.     }
  107. }