Files

105 lines
3.5 KiB
Markdown

# WIFI switch
Это проект комутатора на основе esp8266.
AP - сеть создоваемая самим комутатором
STA - сеть к которой подключается комутатор
Значиния по умолчанию:
AP сеть:
AP SSID: Mirror
AP PASSWORD: *\$sd!Df^67_sS52d
Админка:
Login: admin
Password: admin
![Блок с текущими настройками](screenshots/settings_current.png)
![Настройки AP сети](screenshots/settings_AP.png)
![Настройки STA сети](screenshots/settings_STA.png)
![Смена пвроля администратора](screenshots/settings_admin.png)
## API
Все перечисленные endpoint'ы требуют **HTTP Basic Auth**. При неуспешной авторизации сервер возвращает `401 Unauthorized`. Для запросов с JSON передавайте данные в теле запроса.
Некорректный JSON, неверный формат IP-адреса или отсутствие обязательных полей приводит к ответу `400 Bad Request`.
### Обновление настроек точки доступа (AP)
- **URL:** `/settings/ap_update`
- **Метод:** `POST`
- **Поля JSON:** `ssid` и `pass` должны передаваться вместе; оба поля можно не указывать. Также можно передать `ip`, `gateway` и `mask` независимо друг от друга.
```json
{
"ssid": "Имя_сети_AP",
"pass": "Пароль_сети_AP",
"ip": "192.168.4.1",
"gateway": "192.168.4.1",
"mask": "255.255.255.0"
}
```
Ответ: `200 OK`; после сохранения устройство перезагружается.
### Обновление настроек подключения к внешней сети (STA)
- **URL:** `/settings/sta_update`
- **Метод:** `POST`
- **Обязательные поля JSON:** `is_conn_out` (boolean), `ssid` и `pass` (строки).
```json
{
"is_conn_out": true,
"ssid": "Имя_вашего_WIFI",
"pass": "Пароль_от_WIFI"
}
```
Ответ: `200 OK`. Если `is_conn_out` равен `true`, устройство перезагружается. При `true` поле `ssid` не может быть пустым.
### Изменение пароля администратора
- **URL:** `/settings/admin_update`
- **Метод:** `POST`
- **Обязательное поле JSON:** `new_pass`.
```json
{
"new_pass": "Новый_пароль_админа"
}
```
Ответ: `200 OK`.
### Получение текущих настроек
Возвращает настройки сети без паролей.
- **URL:** `/settings/current_settings`
- **Метод:** `GET`
- **Ответ:** `200 OK`, `application/json`.
```json
{
"ip": "192.168.4.1",
"gateway": "192.168.4.1",
"mask": "255.255.255.0",
"sta_ssid": "Имя_вашего_WIFI",
"ap_ssid": "Имя_сети_AP",
"is_conn_out": true
}
```
### Получение списка подключенных клиентов
Возвращает IP- и MAC-адреса устройств, подключенных к точке доступа (SoftAP).
- **URL:** `/user_list`
- **Метод:** `GET`
- **Ответ:** `200 OK`, `application/json`.
```json
{
"user_ip": ["192.168.4.2", "192.168.4.3"],
"user_mac": ["a1:b2:c3:d4:e5:f6", "7a:8b:9c:0d:1e:2f"]
}
```