Махалли (МФЙ)

Махаллинские сходы граждан (МФЙ) внутри районов.

Метод	Адрес	Назначение
GET	/admin/region/mfy	Список махаллей
GET	/admin/region/mfy/{model}	Карточка махалли
POST	/admin/region/mfy	Создать махаллю
PUT	/admin/region/mfy/{model}	Изменить махаллю
DELETE	/admin/region/mfy/{model}	Удалить махаллю
DELETE	/admin/region/mfy/{value}/restore	Восстановить махаллю

Список махаллей

GET/admin/region/mfy

Постраничный список МФЙ.

Заголовки

Заголовок	Значение	Описание
Authorization	Bearer {token}	Токен из POST /common/auth/login
Accept	application/json	Ответ в JSON
Accept-Language	ru	Язык сообщений и названий: ru, uz, oz

Параметры запроса

Параметр	Описание
filter[id]	ID — точное значение
filter[district_id]	Район — точное значение
filter[name]	Название — поиск по части строки
sort[]	Сортировка, - — по убыванию: id, -id, name, -name
with[]	Подгрузить связи: district, district.region
page	Номер страницы, с 1
page-size	Записей на странице, не больше 20

GET /admin/region/mfy?filter[id]=1&filter[region_id]=1&filter[name]=MFY

Ответ · 200

Постраничный ответ: записи в data[], пагинация в links и meta.

Поля ответа

Поле	Тип	Описание
data	object[]	Данные
data[].id	integer	ID
data[].district_id	integer	Район
data[].name	string	Название
data[].created_at	string	Создано
data[].updated_at	string	Обновлено
data[].is_deleted	boolean

{
    "data": [
        {
            "id": 1,
            "district_id": 1,
            "name": "MFY 1",
            "created_at": "2026-09-30 12:47:58",
            "updated_at": "2026-09-30 12:47:58",
            "is_deleted": false
        }
    ],
    "links": {
        "first": "https://api.wasyt.uz/admin/region/mfy?page=1",
        "last": "https://api.wasyt.uz/admin/region/mfy?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/admin/region/mfy",
        "per_page": 20,
        "to": 1,
        "total": 1
    }
}

Карточка махалли

GET/admin/region/mfy/{model}

Возвращает МФЙ по ID.

Заголовки

Заголовок	Значение	Описание
Authorization	Bearer {token}	Токен из POST /common/auth/login
Accept	application/json	Ответ в JSON
Accept-Language	ru	Язык сообщений и названий: ru, uz, oz

Параметры пути

Параметр	Описание
model	ID записи

Ответ · 200

Поля ответа

Поле	Тип	Описание
id	integer	ID
district_id	integer	Район
name	string	Название
created_at	string	Создано
updated_at	string	Обновлено
is_deleted	boolean

{
    "id": 1,
    "district_id": 1,
    "name": "MFY 1",
    "created_at": "2026-09-30 12:47:58",
    "updated_at": "2026-09-30 12:47:58",
    "is_deleted": false
}

Создать махаллю

POST/admin/region/mfy

Создаёт МФЙ в районе district_id; название уникально в пределах района.

Заголовки

Заголовок	Значение	Описание
Authorization	Bearer {token}	Токен из POST /common/auth/login
Accept	application/json	Ответ в JSON
Accept-Language	ru	Язык сообщений и названий: ru, uz, oz

Тело запроса

Поле	Тип	Обязательно	Описание
district_id	integer	Да	Район. ID существующей записи, доступной пользователю
name	string	Да	Название. Макс. 255 символов. Уникальное значение в компании

JSON

{
    "district_id": 2,
    "name": "MFY 3"
}

cURL

curl -X POST "https://api.wasyt.uz/admin/region/mfy" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"district_id":2,"name":"MFY 3"}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
district_id	integer	Район
name	string	Название
updated_at	string	Обновлено
created_at	string	Создано
id	integer	ID
is_deleted	boolean

{
    "district_id": 2,
    "name": "MFY 3",
    "updated_at": "2026-09-30 12:50:14",
    "created_at": "2026-09-30 12:50:14",
    "id": 3,
    "is_deleted": false
}

Изменить махаллю

PUT/admin/region/mfy/{model}

Обновляет район и название МФЙ.

Из формы (multipart/form-data) метод PUT отправляется как POST с параметром ?_method=PUT.

Заголовки

Заголовок	Значение	Описание
Authorization	Bearer {token}	Токен из POST /common/auth/login
Accept	application/json	Ответ в JSON
Accept-Language	ru	Язык сообщений и названий: ru, uz, oz

Параметры пути

Параметр	Описание
model	ID записи

Тело запроса

Поле	Тип	Обязательно	Описание
district_id	integer	Да	Район. ID существующей записи, доступной пользователю
name	string	Да	Название. Макс. 255 символов. Уникальное значение в компании

JSON

{
    "district_id": 1,
    "name": "MFY 1"
}

cURL

curl -X PUT "https://api.wasyt.uz/admin/region/mfy/1" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"district_id":1,"name":"MFY 1"}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
id	integer	ID
district_id	integer	Район
name	string	Название
created_at	string	Создано
updated_at	string	Обновлено
is_deleted	boolean

{
    "id": 1,
    "district_id": 1,
    "name": "MFY 1",
    "created_at": "2026-09-30 12:47:58",
    "updated_at": "2026-09-30 12:50:16",
    "is_deleted": false
}

Удалить махаллю

DELETE/admin/region/mfy/{model}

Мягко удаляет МФЙ; её можно восстановить.

Из формы (multipart/form-data) метод DELETE отправляется как POST с параметром ?_method=DELETE.

Заголовки

Заголовок	Значение	Описание
Authorization	Bearer {token}	Токен из POST /common/auth/login
Accept	application/json	Ответ в JSON
Accept-Language	ru	Язык сообщений и названий: ru, uz, oz

Параметры пути

Параметр	Описание
model	ID записи

Ответ · 200

Поля ответа

Поле	Тип	Описание
message	string	Сообщение

{
    "message": "Success"
}

Восстановить махаллю

DELETE/admin/region/mfy/{value}/restore

Восстанавливает удалённую МФЙ по ID {value}.

Из формы (multipart/form-data) метод DELETE отправляется как POST с параметром ?_method=DELETE.

Заголовки

Заголовок	Значение	Описание
Authorization	Bearer {token}	Токен из POST /common/auth/login
Accept	application/json	Ответ в JSON
Accept-Language	ru	Язык сообщений и названий: ru, uz, oz

Параметры пути

Параметр	Описание
value	ID записи (в том числе удалённой)

Ответ · 200

Поля ответа

Поле	Тип	Описание
message	string	Сообщение

{
    "message": "Success"
}