🔐 签名接口

<?php
declare(strict_types=1);

use think\admin\service\InterfaceService;

// 实例接口服务对象
$service = InterfaceService::instance();

// 设置接口请求网关（可选）
$service->getway('https://api.example.com');

// 设置接口认证账号
$service->setAuth('your_app_id', 'your_app_key');

// 准备请求数据
$data = [
    'user_id' => 123,
    'action' => 'getUserInfo'
];

// 发起接口请求
$result = $service->doRequest('/api/data/getUserInfo', $data);

// 处理返回结果
if ($result['code'] === 1) {
    echo "请求成功：" . $result['info'] . "\n";
    print_r($result['data']);
} else {
    echo "请求失败：" . $result['info'] . "\n";
}

<?php
declare(strict_types=1);

namespace app\data\controller\api;

use think\admin\Controller;
use think\admin\service\InterfaceService;

/**
 * 接口授权基础控制器
 * @class Auth
 * @package app\data\controller\api
 */
class Auth extends Controller
{
    /**
     * 当前请求数据
     * @var array
     */
    protected $data;

    /**
     * 接口ID
     * @var string
     */
    protected $appid = 'your_app_id';

    /**
     * 接口密钥
     * @var string
     */
    protected $appkey = 'your_app_key';

    /**
     * 接口服务对象
     * @var InterfaceService
     */
    protected $interface;

    /**
     * 接口授权初始化
     */
    protected function initialize()
    {
        // 实例接口对象
        $this->interface = InterfaceService::instance();
        
        // 设置接口认证账号
        $this->interface->setAuth($this->appid, $this->appkey);
        
        // 获取并验证接口数据（会自动验证签名）
        $this->data = $this->interface->getData();
    }

    /**
     * 响应错误消息
     * @param mixed $info 错误信息
     * @param mixed $data 错误数据
     * @param mixed $code 错误代码
     */
    public function error($info, $data = '{-null-}', $code = 0): void
    {
        $this->interface->error($info, $data, $code);
    }

    /**
     * 响应成功消息
     * @param mixed $info 成功信息
     * @param mixed $data 成功数据
     * @param mixed $code 成功代码
     */
    public function success($info, $data = '{-null-}', $code = 1): void
    {
        $this->interface->success($info, $data, $code);
    }

    /**
     * 响应高级数据
     * @param array $data 响应数据
     */
    protected function response(array $data = []): void
    {
        $this->interface->baseSuccess('接口调用成功！', $data);
    }
}

<?php
declare(strict_types=1);

namespace app\data\controller\api;

use think\admin\Controller;
use think\admin\service\InterfaceService;

/**
 * 接口授权基础控制器（数据库管理账号版本）
 * @class Auth
 * @package app\data\controller\api
 */
class Auth extends Controller
{
    /**
     * 当前请求数据
     * @var array
     */
    protected $data;

    /**
     * 接口账号信息
     * @var array
     */
    protected $user;

    /**
     * 接口服务对象
     * @var InterfaceService
     */
    protected $interface;

    /**
     * 接口授权初始化（从数据库读取账号）
     */
    protected function initialize()
    {
        // 接口实例初始化
        $this->interface = InterfaceService::instance();

        // 验证 appid 参数
        $map = $this->_vali(['appid.require' => '参数APPID不能为空！']);
        
        // 从数据库中查询账号（使用自己的数据表）
        $this->user = $this->app->db->name('AppUser')->where($map)->find();

        // 验证账号是否存在
        if (empty($this->user)) {
            $this->interface->error('接口账号不存在！');
        }

        // 验证账号状态
        if (empty($this->user['status'])) {
            $this->interface->error('接口账号已被禁用！');
        }

        // 验证账号是否已删除
        if (!empty($this->user['is_deleted'])) {
            $this->interface->error('接口账号已被移除！');
        }

        // 接口数据初始化（使用数据库中的账号信息）
        $this->interface->setAuth($this->user['appid'], $this->user['appkey']);
        
        // 获取并验证接口数据
        $this->data = $this->interface->getData();
    }

    /**
     * 响应错误消息
     */
    public function error($info, $data = '{-null-}', $code = 0): void
    {
        $this->interface->error($info, $data, $code);
    }

    /**
     * 响应成功消息
     */
    public function success($info, $data = '{-null-}', $code = 1): void
    {
        $this->interface->success($info, $data, $code);
    }
}

<?php
declare(strict_types=1);

namespace app\data\controller\api;

use think\admin\helper\QueryHelper;
use think\admin\model\SystemUser;

/**
 * API 接口控制器示例
 * @class Api
 * @package app\data\controller\api
 */
class Api extends Auth
{
    /**
     * 获取用户列表
     * 接口地址：/data/api/getUserList
     */
    public function getUserList()
    {
        // 接收并验证参数（从 $this->data 中获取已解析的数据）
        $data = $this->_vali([
            'page.integer' => '页码格式错误！',
            'limit.integer' => '每页数量格式错误！',
            'status.in:0,1' => '状态值范围异常！'
        ], $this->data, [$this, 'error']);
        
        // 使用模型方法进行查询（推荐方式）
        $query = SystemUser::mQuery();
        $query->where(['is_deleted' => 0])
              ->like('username,nickname')
              ->equal('status')
              ->order('id desc');
        
        // 返回分页查询结果
        $this->success("获取成功", $query->page(true, false));
    }

    /**
     * 获取用户详情
     * 接口地址：/data/api/getUserInfo
     */
    public function getUserInfo()
    {
        // 验证必填参数
        $data = $this->_vali([
            'user_id.require' => '用户ID不能为空！',
            'user_id.integer' => '用户ID格式错误！'
        ], $this->data, [$this, 'error']);
        
        // 查询用户信息
        $user = SystemUser::mk()->where([
            'id' => $data['user_id'],
            'is_deleted' => 0
        ])->find();
        
        if (empty($user)) {
            $this->error('用户不存在！');
        }
        
        // 返回用户信息
        $this->success("获取成功", $user->toArray());
    }

    /**
     * 更新用户状态
     * 接口地址：/data/api/updateUserStatus
     */
    public function updateUserStatus()
    {
        // 验证参数
        $data = $this->_vali([
            'user_id.require' => '用户ID不能为空！',
            'status.require' => '状态值不能为空！',
            'status.in:0,1' => '状态值范围异常！'
        ], $this->data, [$this, 'error']);
        
        // 更新用户状态
        $result = SystemUser::mk()->where('id', $data['user_id'])->update([
            'status' => $data['status'],
            'update_at' => date('Y-m-d H:i:s')
        ]);
        
        if ($result) {
            $this->success("更新成功");
        } else {
            $this->error("更新失败");
        }
    }
}