README

这是一个为Laravel框架开发的慧享科技API服务扩展，提供了与慧享科技SCAASP平台和SaaS平台的API交互能力。

功能特性

• 支持慧享科技SCAASP平台API调用
• 支持慧享科技SaaS平台API调用
• 自动处理认证和令牌刷新
• 支持多应用实例配置
• 提供简洁的API调用接口
• 支持自定义配置和响应处理

安装方法

使用Composer安装扩展：

composer require guolei19850528/laravel-wisharetec

配置说明

发布配置文件

安装完成后，运行以下命令发布配置文件：

php artisan vendor:publish --provider="Guolei19850528\LaravelWisharetec\ServiceProvider"

发布后的配置文件位于 config/guolei19850528-laravel-wisharetec-config.php。

配置参数

配置文件包含两个主要部分：SCAASP平台配置和SaaS平台配置。

return [
    'scaasp' => [
        'your app id' => [
            'baseUrl' => env('WISHARETEC_SCAASP_BASE_URL', 'https://scaasp.wisharetec.com/api/'),
            'username' => env('WISHARETEC_SCAASP_USERNAME', 'your_username'),
            'password' => env('WISHARETEC_SCAASP_PASSWORD', 'your_password'),
        ],
    ],
    'saas' => [
        'your app id' => [
            'baseUrl' => env('WISHARETEC_SAAS_BASE_URL', 'https://saas.wisharetec.com/api/'),
            'account' => env('WISHARETEC_SAAS_ACCOUNT', 'your_account'),
            'password' => env('WISHARETEC_SAAS_PASSWORD', 'your_password'),
        ],
    ],
];

使用方法

基本使用

SCAASP平台API

use Guolei19850528\LaravelWisharetec\Scaasp\Api;

// 创建API客户端实例
$api = new Api();

// 检查登录状态
if (!$api->loginState()) {
    // 登录获取令牌
    $api->login();
}

// 发送API请求
$response = $api->request('POST', 'api/path', [
    'param1' => 'value1',
    'param2' => 'value2'
]);

// 处理响应
if ($response['success']) {
    $data = $response['data'];
    // 处理数据
} else {
    $error = $response['error'];
    // 处理错误
}

SaaS平台API

use Guolei19850528\LaravelWisharetec\Saas\Api;

// 创建API客户端实例
$api = new Api();

// 登录获取令牌
$api->login();

// 获取管理树数据
$treeData = $api->manageTree();

// 发送API请求
$response = $api->request('POST', 'api/path', [
    'param1' => 'value1',
    'param2' => 'value2'
]);

// 处理响应
if ($response['success']) {
    $data = $response['data'];
    // 处理数据
} else {
    $error = $response['error'];
    // 处理错误
}

自定义配置

use Guolei19850528\LaravelWisharetec\Scaasp\Api;

// 使用自定义配置
$config = [
    'baseUrl' => 'https://custom-scaasp.wisharetec.com/api/',
    'username' => 'custom_username',
    'password' => 'custom_password'
];

$api = new Api($config);

API文档

Scaasp\Api类

构造函数

public function __construct($config = null)

• $config: 可选，自定义配置数组

loginState()

public function loginState()

检查登录状态，返回布尔值。

login()

public function login()

登录到SCAASP平台，获取访问令牌。

refreshToken()

public function refreshToken()

刷新访问令牌。

request($method, $api, $params = [])

public function request($method, $api, $params = [])

发送API请求。

• $method: HTTP请求方法（GET/POST等）
• $api: API路径
• $params: 请求参数
• 返回：响应数据数组

Saas\Api类

构造函数

public function __construct($config = null)

• $config: 可选，自定义配置数组

manageTree()

public function manageTree()

获取管理树数据。

login()

public function login()

登录到SaaS平台，获取访问令牌。

refreshToken()

public function refreshToken()

刷新访问令牌。

request($method, $api, $params = [])

public function request($method, $api, $params = [])

发送API请求。

• $method: HTTP请求方法（GET/POST等）
• $api: API路径
• $params: 请求参数
• 返回：响应数据数组

许可证

本扩展使用MIT许可证。

作者信息

• 作者：郭磊
• 邮箱：174000902@qq.com
• GitHub：https://gitee.com/guolei19850528/laravel-wisharetec