{"id":17441200,"url":"https://github.com/tmigone/myhabeetat-api","last_synced_at":"2026-01-20T15:33:15.497Z","repository":{"id":49663125,"uuid":"131441658","full_name":"tmigone/myhabeetat-api","owner":"tmigone","description":"Web API for MyHabeetat's cloud services. Supports Solidmation devices, including BGH Smart Control.","archived":false,"fork":false,"pushed_at":"2023-03-01T22:09:20.000Z","size":479,"stargazers_count":2,"open_issues_count":10,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-13T23:36:07.668Z","etag":null,"topics":["alexa-skill","bgh","bgh-smart-control","myhabeetat","oauth2","solidmation"],"latest_commit_sha":null,"homepage":"http://myhabeetat.tmigone.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tmigone.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-28T20:23:30.000Z","updated_at":"2022-12-10T04:33:57.000Z","dependencies_parsed_at":"2024-10-20T14:23:10.641Z","dependency_job_id":null,"html_url":"https://github.com/tmigone/myhabeetat-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tmigone/myhabeetat-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmigone%2Fmyhabeetat-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmigone%2Fmyhabeetat-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmigone%2Fmyhabeetat-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmigone%2Fmyhabeetat-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmigone","download_url":"https://codeload.github.com/tmigone/myhabeetat-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmigone%2Fmyhabeetat-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28606142,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T14:45:23.139Z","status":"ssl_error","status_checked_at":"2026-01-20T14:44:16.929Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["alexa-skill","bgh","bgh-smart-control","myhabeetat","oauth2","solidmation"],"created_at":"2024-10-17T15:10:45.858Z","updated_at":"2026-01-20T15:33:15.473Z","avatar_url":"https://github.com/tmigone.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# myhabeetat-api\n\nWeb API for [MyHabeetat's cloud platform](https://myhabeetat.solidmation.com/) (including BGH Smart Control devices).\n\nLive URL: https://myhabeetat.tmigone.com\n\n**Features**\n- Endpoints that adapt MyHabeetat's cloud authentication to an OAuth 2.0 compliant login. This was created to do [Account Linking](https://developer.amazon.com/en-US/docs/alexa/account-linking/configure-authorization-code-grant.html) with [this](https://github.com/tmigone/alexa-skill-my-habeetat) Alexa custom Skill, but could also work with any service that requires OAuth authentication.\n- Web API version of [myhabeetat](https://github.com/tmigone/myhabeetat/) library. This allows you to control your devices using HTTP requests.\n\nNote: You don't need to deploy or configure this project if you want to control BGH Smart Control devices with the Alexa skill linked above. \n\n## Endpoints\n\nProject's base URL: https://myhabeetat.tmigone.com\n\n### Healthcheck\n| Endpoint | URL | Parameters | Description |\n| --------- | --------- | --------- | --------- |\n| GET `/health` | https://myhabeetat.tmigone.com/health | none | Check if the API is up. |\n\n### OAuth 2.0\n\nFor an overview of Alexa authorization code grant flow, visit this site: [Account Linking](https://developer.amazon.com/en-US/docs/alexa/account-linking/configure-authorization-code-grant.html)\n\n| Endpoint | URL | Parameters | Description |\n| --------- | --------- | --------- | --------- |\n| GET `/v1/oauth/autorize` | https://myhabeetat.tmigone.com/v1/oauth/authorize | Querystring: `state`, `redirect_uri` | Present authorization UI |\n| GET `/v1/oauth/autorize/callback` | https://myhabeetat.tmigone.com/v1/oauth/authorize/callback | Querystring: `state`, `redirect_uri`, `uname`, `psw` | Verifies credentials and presents authorization code |\n| POST `/v1/oauth/access_token` | https://myhabeetat.tmigone.com/v1/oauth/access_token | Body: `code` | Verify codeand grant access token |\n\n![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/ask-accountlinking/auth-code-grant-flow-sequence._TTH_.png)\n\n### API\n\nHTTP API that interacts with MyHabeetat's cloud platform. For a detailed explanation of parameters, return values from exposed methods see here: https://github.com/tmigone/myhabeetat/#myhabeetat-methods\n\n| Endpoint | URL | Parameters | Description |\n| --------- | --------- | --------- | --------- |\n| POST `/v1/api/login` | https://myhabeetat.tmigone.com/v1/api/login | Body: `email`, `password` | Get an auth token |\n| GET `/v1/api/homes` | https://myhabeetat.tmigone.com/v1/api/homes | Body: `token` | Get available homes |\n| GET `/v1/api/devices` | https://myhabeetat.tmigone.com/v1/api/devices | Body: `token`, `home` | Get available devices |\n| GET `/v1/api/status` | https://myhabeetat.tmigone.com/v1/api/status | Body: `token`, `home`, `device` | Get device status |\n| POST `/v1/api/status` | https://myhabeetat.tmigone.com/v1/api/status | Body: `token`, `model`, `endpoint`. Optional: `mode`, `fanMode`, `targetTemperature` | Set device status |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmigone%2Fmyhabeetat-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmigone%2Fmyhabeetat-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmigone%2Fmyhabeetat-api/lists"}