105 lines
3.5 KiB
Markdown
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
|
|
|
|

|
|
|
|

|
|
|
|

|
|
|
|

|
|
|
|
## 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"]
|
|
}
|
|
```
|