{"id":22454231,"url":"https://github.com/bsy0318/skt-iot-api","last_synced_at":"2026-05-09T14:40:34.558Z","repository":{"id":230175853,"uuid":"778667788","full_name":"bsy0318/SKT-IoT-API","owner":"bsy0318","description":"NUGU 스마트홈 디바이스를 제어하기 위한 비공식 API 서버입니다. Homebridge, HomeAssistant에 사용 가능합니다.","archived":false,"fork":false,"pushed_at":"2024-03-28T07:13:45.000Z","size":9,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T13:15:45.409Z","etag":null,"topics":["home-automation","home-bridge","homeassistant","homebridge","iot"],"latest_commit_sha":null,"homepage":"","language":"Python","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/bsy0318.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}},"created_at":"2024-03-28T06:52:20.000Z","updated_at":"2025-03-10T17:34:37.000Z","dependencies_parsed_at":"2024-03-28T07:42:39.550Z","dependency_job_id":"fd488a68-bbc9-44d3-891d-253c662a4fc2","html_url":"https://github.com/bsy0318/SKT-IoT-API","commit_stats":null,"previous_names":["bsy0317/skt-iot-api","bsy0318/skt-iot-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsy0318%2FSKT-IoT-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsy0318%2FSKT-IoT-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsy0318%2FSKT-IoT-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsy0318%2FSKT-IoT-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bsy0318","download_url":"https://codeload.github.com/bsy0318/SKT-IoT-API/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245850360,"owners_count":20682647,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["home-automation","home-bridge","homeassistant","homebridge","iot"],"created_at":"2024-12-06T07:07:20.549Z","updated_at":"2026-05-09T14:40:34.522Z","avatar_url":"https://github.com/bsy0318.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NUGU 스마트홈 API 서버 🏠💡\n\nNUGU 스마트홈 디바이스를 제어하기 위한 비공식 API 서버입니다.  \n반디스마트스위치 BDS03B에서 테스트되었으며, 현재는 전원 제어만 지원합니다.\n\n## Prerequisites 🛠️\n\n\u003e `authorization`, `widgetId` 값은 Packet Capture를 통해 얻을 수 있습니다.\n- NUGU 스마트홈에서 얻은 `authorization`  Key\n- NUGU 스마트홈에서 얻은 `widgetId`  Value  \n\n## Installation 🚀\n\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/bsy0317/SKT-IoT-API.git\n    ```\n\n2. Navigate to the project directory:\n\n    ```bash\n    cd SKT-IoT-API\n    ```\n\n3. Install dependencies:\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n## Configuration ⚙️\n\n프로젝트 디렉토리에 `settings.ini` 파일이 필요합니다. `settings.ini` 파일은 `settings_sample.ini` 파일을 참고하여 작성하시면 됩니다.\n\n\n## Usage ℹ️\n\n### Windows 🖥️\n\n1. Python dependencies를 설치합니다.\n```bash\npip install -r requirements.txt\n```\n\n2.  `run_windows.bat` 스크립트를 실행합니다.\n   ```bash\nrun_windows.bat\n```\n\n### Linux 🐧\n\n1. Python dependencies를 설치합니다.\n```bash\npip install -r requirements.txt\n```\n\n2. `run_linux.sh` 스크립트를 실행합니다.\n```bash\n./run_linux.sh\n```\n\n## Endpoints 📡\n\n### Control Device\n\n- **Endpoint:** `/controlDevice/\u003caction\u003e`\n- **Methods:** GET\n- **Description:** Controls the device by turning it on or off.\n- **Actions:**\n  - `on`: Turns the device on.\n  - `off`: Turns the device off.\n\n### Check Status\n\n- **Endpoint:** `/controlDevice/status`\n- **Methods:** GET\n- **Description:** Checks the status of the device.\n\n## License 📝\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsy0318%2Fskt-iot-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbsy0318%2Fskt-iot-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsy0318%2Fskt-iot-api/lists"}