giannisftaras / ge-api
通用电气 - SmartHQ API 的 PHP 封装器
1.0.0
2022-01-01 16:14 UTC
Requires
- php: >=7.1.0
- guzzlehttp/guzzle: ^7.4
- voku/simple_html_dom: 4.7.31
README
这个库是一个简单的 PHP 封装器,用于通用电气/SmartHQ API。目前,由于我没有列出所有要测试的设备,所以库只使用了 API 的单个端点。如果您需要支持更多设备,您可以自己实现调用和函数,并通过创建 pull request 将其合并到主分支。
额外需要的库(包含在主包中)
- GuzzleHTTP:用于 API 调用
- SimpleHTMLDOM:用于登录过程
支持的设备
- 分体空调
安装
您可以使用 composer
安装此库,或者简单地下载此存储库并将其包含到您的项目中。使用 composer
安装
composer require giannisftaras/ge-api
用法
请确保实现一个存储对象,以便在登录流程中存储生成的 Bearer / 访问令牌,这有助于加快加载速度,并在查询 API 时避免频繁登录。
<?php require __DIR__ . '/../vendor/autoload.php'; $auth = parse_ini_file(__DIR__ . '/auth.ini'); session_start(); # Get the stored GE Bearer token from $_SESSION or from wherever you like $ge_token = $_SESSION['GE_token'] ?? NULL; # Setup the GE class $ge = new \GE\GE($auth['username'], $auth['password'], $ge_token); # Initialize the GE class and get a bearer token in return $return_token = $ge->init(); # Store the returned token to a $_SESSION or setup your own storage object $_SESSION['GE_token'] = $return_token; # Initialize the GE\User object $ge_user = new \GE\User(); # Get user appliances $appl = $ge_user->get_appliances()[0]; # Run commands on the appliance $appl->power_on(); $appl->set_temperature(25); ?>
您可以在 /src/geAPI/commands/ac_commands.php
中查看 AC 类的所有可用函数和命令。