Районы

Районы (города) внутри областей; компания привязывается к району полем district_id.

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

Список районов

GET/admin/region/district

Постраничный список районов.

Заголовки

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

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

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

http

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

Ответ · 200

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

Поля ответа

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

json

{
    "data": [
        {
            "id": 1,
            "region_id": 1,
            "name": "District 1",
            "iso_code": 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/district?page=1",
        "last": "https://api.wasyt.uz/admin/region/district?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/admin/region/district",
        "per_page": 20,
        "to": 1,
        "total": 1
    }
}

Карточка района

GET/admin/region/district/{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
`region_id`	integer	Регион
`name`	string	Название
`iso_code`	integer	ISO код
`created_at`	string	Создано
`updated_at`	string	Обновлено
`is_deleted`	boolean

json

{
    "id": 1,
    "region_id": 1,
    "name": "District 1",
    "iso_code": 1,
    "created_at": "2026-09-30 12:47:58",
    "updated_at": "2026-09-30 12:47:58",
    "is_deleted": false
}

Создать район

POST/admin/region/district

Создаёт район в области region_id; название уникально в пределах области, iso_code — целое число.

Заголовки

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

Тело запроса

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

JSONcURL

json

{
    "region_id": 2,
    "name": "District 3",
    "iso_code": "3"
}

bash

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

Ответ · 200

Поля ответа

Поле	Тип	Описание
`region_id`	integer	Регион
`name`	string	Название
`iso_code`	integer	ISO код
`updated_at`	string	Обновлено
`created_at`	string	Создано
`id`	integer	ID
`is_deleted`	boolean

json

{
    "region_id": 2,
    "name": "District 3",
    "iso_code": 3,
    "updated_at": "2026-09-30 12:50:12",
    "created_at": "2026-09-30 12:50:12",
    "id": 3,
    "is_deleted": false
}

Изменить район

PUT/admin/region/district/{model}

Обновляет область, название и ISO-код района.

Из формы (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 записи

Тело запроса

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

JSONcURL

json

{
    "region_id": 1,
    "name": "District 1",
    "iso_code": "1"
}

bash

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

Ответ · 200

Поля ответа

Поле	Тип	Описание
`id`	integer	ID
`region_id`	integer	Регион
`name`	string	Название
`iso_code`	integer	ISO код
`created_at`	string	Создано
`updated_at`	string	Обновлено
`is_deleted`	boolean

json

{
    "id": 1,
    "region_id": 1,
    "name": "District 1",
    "iso_code": 1,
    "created_at": "2026-09-30 12:47:58",
    "updated_at": "2026-09-30 12:50:14",
    "is_deleted": false
}

Удалить район

DELETE/admin/region/district/{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	Сообщение

json

{
    "message": "Success"
}

Восстановить район

DELETE/admin/region/district/{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	Сообщение

json

{
    "message": "Success"
}

Районы ​

Список районов ​

Заголовки ​

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

Ответ · 200 ​

Карточка района ​

Заголовки ​

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

Ответ · 200 ​

Создать район ​

Заголовки ​

Тело запроса ​

Ответ · 200 ​

Изменить район ​

Заголовки ​

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

Тело запроса ​

Ответ · 200 ​

Удалить район ​

Заголовки ​

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

Ответ · 200 ​

Восстановить район ​

Заголовки ​

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

Ответ · 200 ​

Районы

Список районов

Заголовки

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

Ответ · 200

Карточка района

Заголовки

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

Ответ · 200

Создать район

Заголовки

Тело запроса

Ответ · 200

Изменить район

Заголовки

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

Тело запроса

Ответ · 200

Удалить район

Заголовки

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

Ответ · 200

Восстановить район

Заголовки

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

Ответ · 200