{"id":42160659,"url":"https://github.com/giannisftaras/ge-api","last_synced_at":"2026-01-26T20:05:43.773Z","repository":{"id":40352494,"uuid":"443531180","full_name":"giannisftaras/ge-api","owner":"giannisftaras","description":"PHP wrapper for the General Electric - SmartHQ API","archived":false,"fork":false,"pushed_at":"2022-05-13T11:21:37.000Z","size":386,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-21T14:51:51.751Z","etag":null,"topics":["api","library","php","smarthq"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/giannisftaras.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-01T12:09:32.000Z","updated_at":"2023-08-30T01:35:39.000Z","dependencies_parsed_at":"2022-08-09T18:01:01.091Z","dependency_job_id":null,"html_url":"https://github.com/giannisftaras/ge-api","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/giannisftaras/ge-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giannisftaras%2Fge-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giannisftaras%2Fge-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giannisftaras%2Fge-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giannisftaras%2Fge-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/giannisftaras","download_url":"https://codeload.github.com/giannisftaras/ge-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giannisftaras%2Fge-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28786805,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T13:55:28.044Z","status":"ssl_error","status_checked_at":"2026-01-26T13:55:26.068Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","library","php","smarthq"],"created_at":"2026-01-26T20:03:22.407Z","updated_at":"2026-01-26T20:05:43.726Z","avatar_url":"https://github.com/giannisftaras.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PHP - General Electric / SmartHQ API\nThis library is a simple PHP wrapper for the General Electric / SmartHQ API. At the moment the library utilizes only a single endpoint from the API since I don't have all the devices listed to test it with. If you want support for more devices you can implement your own calls \u0026 functions and create a pull request to merge it to the main branch.\n\nAdditional required libraries (included in the main package):\n\n -  [GuzzleHTTP](https://github.com/guzzle/guzzle): for the API calls\n - [SimpleHTMLDOM](https://github.com/voku/simple_html_dom):  for the login process\n\n#### Supported devices:\n - Split Air Conditioner\n\n#### Installation:\nYou can install the library using `composer` or by simply downloading this repository and including it in your project.\nInstallation using `composer`:\n\n    composer require giannisftaras/ge-api\n\n#### Usage:\n\nMake sure you implement a storage object in order to store the Bearer / Access token generated during the login flow which will help in loading times and when quering the API in order to avoid logging in all the time.\n\n```php\n\u003c?php\n\trequire  __DIR__  .  '/../vendor/autoload.php';\n\t$auth = parse_ini_file(__DIR__  .  '/auth.ini');\n\n\tsession_start();\n\t# Get the stored GE Bearer token from $_SESSION or from wherever you like\n\t$ge_token = $_SESSION['GE_token'] ?? NULL;\n\t\t \n\t# Setup the GE class\n\t$ge = new \\GE\\GE($auth['username'], $auth['password'], $ge_token);\n\n\t# Initialize the GE class and get a bearer token in return\n\t$return_token = $ge-\u003einit();\n\n\t# Store the returned token to a $_SESSION or setup your own storage object\n\t$_SESSION['GE_token'] = $return_token;\n\t\n\t# Initialize the GE\\User object\n\t$ge_user = new \\GE\\User();\n\n\t# Get user appliances\n\t$appl = $ge_user-\u003eget_appliances()[0];\n\n\t# Run commands on the appliance\n\t$appl-\u003epower_on();\n\t$appl-\u003eset_temperature(25);\n?\u003e\n```\nYou can view the AC class in `/src/geAPI/commands/ac_commands.php` for all available functions and commands.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiannisftaras%2Fge-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiannisftaras%2Fge-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiannisftaras%2Fge-api/lists"}