Должности

Справочник должностей, каждая привязана к отделу.

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

Список должностей

GET/admin/department/position

Постраничный список должностей.

Заголовки

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

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

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

http

GET /admin/department/position?sort[0]=id&sort[1]=-id&sort[2]=name&sort[3]=-name

Ответ · 200

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

Поля ответа

Поле	Тип	Описание
`data`	object[]	Данные
`data[].id`	integer	ID
`data[].department_id`	integer	Отрасль
`data[].name`	object	Название
`data[].name.oz`	string
`data[].name.ru`	string
`data[].name.uz`	string
`data[].description`	object	Описание
`data[].description.oz`	string
`data[].description.ru`	string
`data[].description.uz`	string
`data[].created_at`	string	Создано
`data[].updated_at`	string	Обновлено
`data[].is_deleted`	boolean

json

{
    "data": [
        {
            "id": 1,
            "department_id": 1,
            "name": {
                "oz": "Department 1 oz",
                "ru": "Department 1 ru",
                "uz": "Department 1 uz"
            },
            "description": {
                "oz": "Description 1 oz",
                "ru": "Description 1 ru",
                "uz": "Description 1 uz"
            },
            "created_at": "2026-09-30 12:47:58",
            "updated_at": "2026-09-30 12:47:58",
            "is_deleted": false
        },
        {
            "id": 2,
            "department_id": 1,
            "name": {
                "oz": "Department 2 oz",
                "ru": "Department 2 ru",
                "uz": "Department 2 uz"
            },
            "description": {
                "oz": "Description 2 oz",
                "ru": "Description 2 ru",
                "uz": "Description 2 uz"
            },
            "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/department/position?page=1",
        "last": "https://api.wasyt.uz/admin/department/position?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/admin/department/position",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}

Карточка должности

GET/admin/department/position/{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
`department_id`	integer	Отрасль
`name`	object	Название
`name.oz`	string
`name.ru`	string
`name.uz`	string
`description`	object	Описание
`description.oz`	string
`description.ru`	string
`description.uz`	string
`created_at`	string	Создано
`updated_at`	string	Обновлено
`is_deleted`	boolean

json

{
    "id": 1,
    "department_id": 1,
    "name": {
        "oz": "Department 1 oz",
        "ru": "Department 1 ru",
        "uz": "Department 1 uz"
    },
    "description": {
        "oz": "Description 1 oz",
        "ru": "Description 1 ru",
        "uz": "Description 1 uz"
    },
    "created_at": "2026-09-30 12:47:58",
    "updated_at": "2026-09-30 12:47:58",
    "is_deleted": false
}

Создать должность

POST/admin/department/position

Создаёт должность в отделе department_id; название обязательно и уникально на каждом языке.

Заголовки

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

Тело запроса

Поле	Тип	Обязательно	Описание
`department_id`	integer	Да	Отрасль. ID существующей записи, доступной пользователю
`name.{lang}`	string	Да	Название. Макс. 255 символов. Уникальное значение в компании
`description.{lang}`	string	Да (можно null)	Описание

JSONcURL

json

{
    "department_id": 1,
    "name": {
        "ru": "Position 3 ru",
        "uz": "Position 3 uz",
        "oz": "Position 3 oz"
    },
    "description": {
        "ru": "Description 3 ru",
        "uz": "Description 3 uz",
        "oz": "Description 3 oz"
    }
}

bash

curl -X POST "https://api.wasyt.uz/admin/department/position" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"department_id":1,"name":{"ru":"Position 3 ru","uz":"Position 3 uz","oz":"Position 3 oz"},"description":{"ru":"Description 3 ru","uz":"Description 3 uz","oz":"Description 3 oz"}}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
`department_id`	integer	Отрасль
`name`	object	Название
`name.ru`	string
`name.uz`	string
`name.oz`	string
`description`	object	Описание
`description.ru`	string
`description.uz`	string
`description.oz`	string
`updated_at`	string	Обновлено
`created_at`	string	Создано
`id`	integer	ID
`is_deleted`	boolean

json

{
    "department_id": 1,
    "name": {
        "ru": "Position 3 ru",
        "uz": "Position 3 uz",
        "oz": "Position 3 oz"
    },
    "description": {
        "ru": "Description 3 ru",
        "uz": "Description 3 uz",
        "oz": "Description 3 oz"
    },
    "updated_at": "2026-09-30 12:49:57",
    "created_at": "2026-09-30 12:49:57",
    "id": 3,
    "is_deleted": false
}

Изменить должность

PUT/admin/department/position/{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 записи

Тело запроса

Поле	Тип	Обязательно	Описание
`department_id`	integer	Да	Отрасль. ID существующей записи, доступной пользователю
`name.{lang}`	string	Да	Название. Макс. 255 символов. Уникальное значение в компании
`description.{lang}`	string	Да (можно null)	Описание

JSONcURL

json

{
    "department_id": 1,
    "name": {
        "ru": "Position 1 ru",
        "uz": "Position 1 uz",
        "oz": "Position 1 oz"
    },
    "description": {
        "ru": "Description 1 ru",
        "uz": "Description 1 uz",
        "oz": "Description 1 oz"
    }
}

bash

curl -X PUT "https://api.wasyt.uz/admin/department/position/1" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"department_id":1,"name":{"ru":"Position 1 ru","uz":"Position 1 uz","oz":"Position 1 oz"},"description":{"ru":"Description 1 ru","uz":"Description 1 uz","oz":"Description 1 oz"}}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
`id`	integer	ID
`department_id`	integer	Отрасль
`name`	object	Название
`name.ru`	string
`name.uz`	string
`name.oz`	string
`description`	object	Описание
`description.ru`	string
`description.uz`	string
`description.oz`	string
`created_at`	string	Создано
`updated_at`	string	Обновлено
`is_deleted`	boolean

json

{
    "id": 1,
    "department_id": 1,
    "name": {
        "ru": "Position 1 ru",
        "uz": "Position 1 uz",
        "oz": "Position 1 oz"
    },
    "description": {
        "ru": "Description 1 ru",
        "uz": "Description 1 uz",
        "oz": "Description 1 oz"
    },
    "created_at": "2026-09-30 12:47:58",
    "updated_at": "2026-09-30 12:49:59",
    "is_deleted": false
}

Удалить должность

DELETE/admin/department/position/{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/department/position/{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