Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 anton
|
278463e611 | ||
 kirill
|
6c8980162c | ||
|
anton
|
9820f97216 |
-680
@@ -1,680 +0,0 @@
|
|||||||
openapi: 3.0.3
|
|
||||||
|
|
||||||
info:
|
|
||||||
title: HRBox API
|
|
||||||
version: 1.0.0
|
|
||||||
description: |
|
|
||||||
API для чтения подразделений, трудоустройств и пользователей.
|
|
||||||
|
|
||||||
Все методы требуют авторизованную сессию HRBox и соответствующее право доступа.
|
|
||||||
Ответ содержит массив `data` и метаданные пагинации `_meta`.
|
|
||||||
|
|
||||||
servers:
|
|
||||||
- url: /api
|
|
||||||
|
|
||||||
tags:
|
|
||||||
- name: department
|
|
||||||
description: Подразделения организационной структуры
|
|
||||||
- name: employment
|
|
||||||
description: Трудоустройства пользователей
|
|
||||||
- name: user
|
|
||||||
description: Пользователи
|
|
||||||
|
|
||||||
paths:
|
|
||||||
/department:
|
|
||||||
get:
|
|
||||||
tags: [department]
|
|
||||||
summary: Получить список подразделений
|
|
||||||
operationId: getDepartments
|
|
||||||
description: Возвращает активные подразделения и организации.
|
|
||||||
x-permissions:
|
|
||||||
- show-structure-page
|
|
||||||
parameters:
|
|
||||||
- $ref: '#/components/parameters/Page'
|
|
||||||
- $ref: '#/components/parameters/PerPage'
|
|
||||||
- $ref: '#/components/parameters/Sort'
|
|
||||||
- $ref: '#/components/parameters/Fields'
|
|
||||||
- $ref: '#/components/parameters/Expand'
|
|
||||||
- name: id
|
|
||||||
in: query
|
|
||||||
description: ID подразделений через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: name
|
|
||||||
in: query
|
|
||||||
description: Поиск по названию
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: parent_id
|
|
||||||
in: query
|
|
||||||
description: ID родительского подразделения
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: chief_id
|
|
||||||
in: query
|
|
||||||
description: ID руководителя
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: is_organization
|
|
||||||
in: query
|
|
||||||
description: Признак организации
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: is_null_parent_id
|
|
||||||
in: query
|
|
||||||
description: Только корневые подразделения
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: status_id
|
|
||||||
in: query
|
|
||||||
description: Статусы подразделений через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: integer
|
|
||||||
- name: chief_only
|
|
||||||
in: query
|
|
||||||
description: Только подразделения текущего руководителя
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: for_boss
|
|
||||||
in: query
|
|
||||||
description: Только управляемые текущим пользователем поддеревья
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
responses:
|
|
||||||
'200':
|
|
||||||
description: Список подразделений
|
|
||||||
content:
|
|
||||||
application/json:
|
|
||||||
schema:
|
|
||||||
allOf:
|
|
||||||
- $ref: '#/components/schemas/PaginatedResponse'
|
|
||||||
- type: object
|
|
||||||
properties:
|
|
||||||
data:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
$ref: '#/components/schemas/Department'
|
|
||||||
'401':
|
|
||||||
$ref: '#/components/responses/Unauthorized'
|
|
||||||
'403':
|
|
||||||
$ref: '#/components/responses/Forbidden'
|
|
||||||
|
|
||||||
/employment:
|
|
||||||
get:
|
|
||||||
tags: [employment]
|
|
||||||
summary: Получить список трудоустройств
|
|
||||||
operationId: getEmployments
|
|
||||||
x-permissions:
|
|
||||||
- user-edit
|
|
||||||
parameters:
|
|
||||||
- $ref: '#/components/parameters/Page'
|
|
||||||
- $ref: '#/components/parameters/PerPage'
|
|
||||||
- $ref: '#/components/parameters/Sort'
|
|
||||||
- $ref: '#/components/parameters/Fields'
|
|
||||||
- $ref: '#/components/parameters/Expand'
|
|
||||||
- name: id
|
|
||||||
in: query
|
|
||||||
description: ID трудоустройства
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: user_id
|
|
||||||
in: query
|
|
||||||
description: ID пользователя
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: department_id
|
|
||||||
in: query
|
|
||||||
description: ID подразделения; учитывается его поддерево
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: chief_id
|
|
||||||
in: query
|
|
||||||
description: ID трудоустройства руководителя
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: position
|
|
||||||
in: query
|
|
||||||
description: Поиск по должности
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: is_main
|
|
||||||
in: query
|
|
||||||
description: Только основное трудоустройство
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: status_id
|
|
||||||
in: query
|
|
||||||
description: Статус трудоустройства
|
|
||||||
schema:
|
|
||||||
type: integer
|
|
||||||
- name: org_num
|
|
||||||
in: query
|
|
||||||
description: Табельные номера через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: string
|
|
||||||
- name: created_at
|
|
||||||
in: query
|
|
||||||
description: Дата или диапазон дат создания в формате `from|to`
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: first_name
|
|
||||||
in: query
|
|
||||||
description: Поиск по имени
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: last_name
|
|
||||||
in: query
|
|
||||||
description: Поиск по фамилии
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: name
|
|
||||||
in: query
|
|
||||||
description: Поиск по имени и фамилии пользователя
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: employment_date
|
|
||||||
in: query
|
|
||||||
description: Дата трудоустройства
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: date
|
|
||||||
- name: fired_date
|
|
||||||
in: query
|
|
||||||
description: Дата увольнения
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: date
|
|
||||||
- name: origin_id
|
|
||||||
in: query
|
|
||||||
description: Внешние ID через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: string
|
|
||||||
- name: origin_organization_id
|
|
||||||
in: query
|
|
||||||
description: Внешний ID организации
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: reg_status_id
|
|
||||||
in: query
|
|
||||||
description: Регистрационные статусы пользователей через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: integer
|
|
||||||
- name: user_list_key
|
|
||||||
in: query
|
|
||||||
description: Ключ сохранённого списка пользователей
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: chief_only
|
|
||||||
in: query
|
|
||||||
description: Текущий пользователь и его прямые подчинённые
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: chief_only_all
|
|
||||||
in: query
|
|
||||||
description: Текущий пользователь и все его подчинённые
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: multipleEmployment
|
|
||||||
in: query
|
|
||||||
description: Фильтр по наличию нескольких трудоустройств
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: searchInAllSubDepartments
|
|
||||||
in: query
|
|
||||||
description: Искать во всех вложенных подразделениях
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
responses:
|
|
||||||
'200':
|
|
||||||
description: Список трудоустройств
|
|
||||||
content:
|
|
||||||
application/json:
|
|
||||||
schema:
|
|
||||||
allOf:
|
|
||||||
- $ref: '#/components/schemas/PaginatedResponse'
|
|
||||||
- type: object
|
|
||||||
properties:
|
|
||||||
data:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
$ref: '#/components/schemas/Employment'
|
|
||||||
'401':
|
|
||||||
$ref: '#/components/responses/Unauthorized'
|
|
||||||
'403':
|
|
||||||
$ref: '#/components/responses/Forbidden'
|
|
||||||
|
|
||||||
/user:
|
|
||||||
get:
|
|
||||||
tags: [user]
|
|
||||||
summary: Получить список пользователей
|
|
||||||
operationId: getUsers
|
|
||||||
x-permissions:
|
|
||||||
anyOf:
|
|
||||||
- user-list
|
|
||||||
- show-user-page
|
|
||||||
- user-invite
|
|
||||||
- authenticated user with reports
|
|
||||||
parameters:
|
|
||||||
- $ref: '#/components/parameters/Page'
|
|
||||||
- $ref: '#/components/parameters/PerPage'
|
|
||||||
- $ref: '#/components/parameters/Sort'
|
|
||||||
- $ref: '#/components/parameters/Fields'
|
|
||||||
- $ref: '#/components/parameters/Expand'
|
|
||||||
- name: searchQuery
|
|
||||||
in: query
|
|
||||||
description: Сквозной полнотекстовый поиск пользователей
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: q
|
|
||||||
in: query
|
|
||||||
description: Поиск по имени
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: id
|
|
||||||
in: query
|
|
||||||
description: ID пользователей через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: not_id
|
|
||||||
in: query
|
|
||||||
description: Исключить пользователя по ID
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: email
|
|
||||||
in: query
|
|
||||||
description: Поиск по электронной почте
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: phone_auth
|
|
||||||
in: query
|
|
||||||
description: Поиск по телефону авторизации
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: name
|
|
||||||
in: query
|
|
||||||
description: Поиск по имени, фамилии и отчеству
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: first_name
|
|
||||||
in: query
|
|
||||||
description: Поиск по имени
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: middle_name
|
|
||||||
in: query
|
|
||||||
description: Поиск по отчеству
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: last_name
|
|
||||||
in: query
|
|
||||||
description: Поиск по фамилии
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: department_id
|
|
||||||
in: query
|
|
||||||
description: ID подразделения; учитывается его поддерево
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: chief_id
|
|
||||||
in: query
|
|
||||||
description: ID руководителя
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: position
|
|
||||||
in: query
|
|
||||||
description: Поиск по должности
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: is_external
|
|
||||||
in: query
|
|
||||||
description: Признак внешнего пользователя
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: reg_status_id
|
|
||||||
in: query
|
|
||||||
description: Регистрационные статусы через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: integer
|
|
||||||
- name: gender_id
|
|
||||||
in: query
|
|
||||||
description: Пол пользователя; несколько значений через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: integer
|
|
||||||
- name: duty_id
|
|
||||||
in: query
|
|
||||||
description: ID внутренней услуги
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: birthday_date
|
|
||||||
in: query
|
|
||||||
description: Дата или диапазон дат рождения
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: created_at
|
|
||||||
in: query
|
|
||||||
description: Дата или диапазон дат создания в формате `from|to`
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: updated_at
|
|
||||||
in: query
|
|
||||||
description: Дата или диапазон дат изменения
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: employment_date
|
|
||||||
in: query
|
|
||||||
description: Дата или диапазон дат трудоустройства
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: is_boss
|
|
||||||
in: query
|
|
||||||
description: Признак руководителя
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: group_id
|
|
||||||
in: query
|
|
||||||
description: ID группы пользователей
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: status
|
|
||||||
in: query
|
|
||||||
description: ID персональных статусов через запятую
|
|
||||||
style: form
|
|
||||||
explode: false
|
|
||||||
schema:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: survey_id
|
|
||||||
in: query
|
|
||||||
description: ID опроса
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: survey_360_matrix_is_approved
|
|
||||||
in: query
|
|
||||||
description: Статус согласования матрицы 360
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: company
|
|
||||||
in: query
|
|
||||||
description: Поиск по компании
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
- name: spec_id
|
|
||||||
in: query
|
|
||||||
description: ID профессиональной области
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: chief_only
|
|
||||||
in: query
|
|
||||||
description: Текущий пользователь и его прямые подчинённые
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: chief_only_all
|
|
||||||
in: query
|
|
||||||
description: Текущий пользователь и все его подчинённые
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: user_list_key
|
|
||||||
in: query
|
|
||||||
description: Ключ сохранённого списка пользователей
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
- name: withoutEmployment
|
|
||||||
in: query
|
|
||||||
description: Только пользователи без трудоустройств
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
- name: searchInAllSubDepartments
|
|
||||||
in: query
|
|
||||||
description: Искать во всех вложенных подразделениях
|
|
||||||
schema:
|
|
||||||
type: boolean
|
|
||||||
responses:
|
|
||||||
'200':
|
|
||||||
description: Список пользователей
|
|
||||||
content:
|
|
||||||
application/json:
|
|
||||||
schema:
|
|
||||||
allOf:
|
|
||||||
- $ref: '#/components/schemas/PaginatedResponse'
|
|
||||||
- type: object
|
|
||||||
properties:
|
|
||||||
data:
|
|
||||||
type: array
|
|
||||||
items:
|
|
||||||
$ref: '#/components/schemas/User'
|
|
||||||
'401':
|
|
||||||
$ref: '#/components/responses/Unauthorized'
|
|
||||||
'403':
|
|
||||||
$ref: '#/components/responses/Forbidden'
|
|
||||||
|
|
||||||
components:
|
|
||||||
parameters:
|
|
||||||
Page:
|
|
||||||
name: page
|
|
||||||
in: query
|
|
||||||
description: Номер страницы, начиная с 1
|
|
||||||
schema:
|
|
||||||
type: integer
|
|
||||||
minimum: 1
|
|
||||||
default: 1
|
|
||||||
PerPage:
|
|
||||||
name: per-page
|
|
||||||
in: query
|
|
||||||
description: Количество элементов на странице
|
|
||||||
schema:
|
|
||||||
type: integer
|
|
||||||
minimum: 1
|
|
||||||
default: 20
|
|
||||||
Sort:
|
|
||||||
name: sort
|
|
||||||
in: query
|
|
||||||
description: Поля сортировки через запятую; префикс `-` задаёт сортировку по убыванию
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
Fields:
|
|
||||||
name: fields
|
|
||||||
in: query
|
|
||||||
description: Возвращаемые поля через запятую
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
Expand:
|
|
||||||
name: expand
|
|
||||||
in: query
|
|
||||||
description: Дополнительные связанные данные через запятую
|
|
||||||
schema:
|
|
||||||
type: string
|
|
||||||
|
|
||||||
responses:
|
|
||||||
Unauthorized:
|
|
||||||
description: Пользователь не авторизован
|
|
||||||
Forbidden:
|
|
||||||
description: Недостаточно прав
|
|
||||||
|
|
||||||
schemas:
|
|
||||||
PaginatedResponse:
|
|
||||||
type: object
|
|
||||||
required: [data, _meta]
|
|
||||||
properties:
|
|
||||||
data:
|
|
||||||
type: array
|
|
||||||
items: {}
|
|
||||||
_meta:
|
|
||||||
$ref: '#/components/schemas/PaginationMeta'
|
|
||||||
|
|
||||||
PaginationMeta:
|
|
||||||
type: object
|
|
||||||
required: [totalCount, pageCount, currentPage, perPage]
|
|
||||||
properties:
|
|
||||||
totalCount:
|
|
||||||
type: integer
|
|
||||||
example: 42
|
|
||||||
pageCount:
|
|
||||||
type: integer
|
|
||||||
example: 3
|
|
||||||
currentPage:
|
|
||||||
type: integer
|
|
||||||
example: 1
|
|
||||||
perPage:
|
|
||||||
type: integer
|
|
||||||
example: 20
|
|
||||||
|
|
||||||
Department:
|
|
||||||
type: object
|
|
||||||
properties:
|
|
||||||
id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
name:
|
|
||||||
type: string
|
|
||||||
description:
|
|
||||||
type: string
|
|
||||||
nullable: true
|
|
||||||
parent_id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
nullable: true
|
|
||||||
chief_id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
nullable: true
|
|
||||||
is_organization:
|
|
||||||
type: boolean
|
|
||||||
status_id:
|
|
||||||
type: integer
|
|
||||||
created_at:
|
|
||||||
type: string
|
|
||||||
format: date-time
|
|
||||||
updated_at:
|
|
||||||
type: string
|
|
||||||
format: date-time
|
|
||||||
|
|
||||||
Employment:
|
|
||||||
type: object
|
|
||||||
properties:
|
|
||||||
id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
user_id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
department_id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
nullable: true
|
|
||||||
chief_id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
nullable: true
|
|
||||||
position:
|
|
||||||
type: string
|
|
||||||
nullable: true
|
|
||||||
is_main:
|
|
||||||
type: boolean
|
|
||||||
employment_date:
|
|
||||||
type: string
|
|
||||||
format: date
|
|
||||||
nullable: true
|
|
||||||
fired_date:
|
|
||||||
type: string
|
|
||||||
format: date
|
|
||||||
nullable: true
|
|
||||||
status_id:
|
|
||||||
type: integer
|
|
||||||
org_num:
|
|
||||||
type: string
|
|
||||||
nullable: true
|
|
||||||
|
|
||||||
User:
|
|
||||||
type: object
|
|
||||||
properties:
|
|
||||||
id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
first_name:
|
|
||||||
type: string
|
|
||||||
middle_name:
|
|
||||||
type: string
|
|
||||||
nullable: true
|
|
||||||
last_name:
|
|
||||||
type: string
|
|
||||||
name:
|
|
||||||
type: string
|
|
||||||
birthday_date:
|
|
||||||
type: string
|
|
||||||
format: date
|
|
||||||
nullable: true
|
|
||||||
reg_status_id:
|
|
||||||
type: integer
|
|
||||||
gender_id:
|
|
||||||
type: integer
|
|
||||||
nullable: true
|
|
||||||
city_id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
nullable: true
|
|
||||||
company:
|
|
||||||
type: string
|
|
||||||
nullable: true
|
|
||||||
is_external:
|
|
||||||
type: boolean
|
|
||||||
photo_file_id:
|
|
||||||
type: string
|
|
||||||
format: uuid
|
|
||||||
nullable: true
|
|
||||||
created_at:
|
|
||||||
type: string
|
|
||||||
format: date-time
|
|
||||||
updated_at:
|
|
||||||
type: string
|
|
||||||
format: date-time
|
|
||||||
+965
@@ -79,6 +79,23 @@ tags:
|
|||||||
description: Methods for admin oversight of personal API tokens. Requires "api-tokens-admin" permission.
|
description: Methods for admin oversight of personal API tokens. Requires "api-tokens-admin" permission.
|
||||||
- name: admin-employment
|
- name: admin-employment
|
||||||
description: Methods for administrative read-only access to employee employments, including external identifiers used by integrations. Requires "user-edit" permission.
|
description: Methods for administrative read-only access to employee employments, including external identifiers used by integrations. Requires "user-edit" permission.
|
||||||
|
- name: admin-shop-product
|
||||||
|
description: |
|
||||||
|
Управление товарами корпоративного магазина (admin). Требуется право `shop-items`
|
||||||
|
и флаг тенанта `enableShop`. Action `items` доступен и менеджеру заказов (`shop-orders`).
|
||||||
|
- name: admin-shop-product-option
|
||||||
|
description: |
|
||||||
|
Варианты (опции) товаров магазина: точечный CRUD по одной опции.
|
||||||
|
Пакетное сохранение опций — через `POST /admin/shop/product/update`.
|
||||||
|
Требуется право `shop-items`.
|
||||||
|
- name: admin-shop-order
|
||||||
|
description: |
|
||||||
|
Обработка заказов магазина: подтверждение, отмена, действия с позициями.
|
||||||
|
Требуется право `shop-orders`.
|
||||||
|
- name: admin-shop-delivery-address
|
||||||
|
description: |
|
||||||
|
Справочник адресов доставки для самовывоза/курьерской доставки. Требуется
|
||||||
|
право `shop-orders`.
|
||||||
|
|
||||||
paths:
|
paths:
|
||||||
/mobile/bind/{id}/{token}:
|
/mobile/bind/{id}/{token}:
|
||||||
@@ -8264,6 +8281,708 @@ paths:
|
|||||||
Запись не найдена. Включает случаи обращения к записям,
|
Запись не найдена. Включает случаи обращения к записям,
|
||||||
принадлежащим другим тенантам.
|
принадлежащим другим тенантам.
|
||||||
|
|
||||||
|
# ============================================================
|
||||||
|
# Admin Shop API (H-2626)
|
||||||
|
# ============================================================
|
||||||
|
|
||||||
|
/admin/shop/product:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Список товаров магазина (admin)
|
||||||
|
operationId: adminShopProductIndex
|
||||||
|
parameters:
|
||||||
|
- name: page
|
||||||
|
in: query
|
||||||
|
schema: { type: integer, minimum: 1, default: 1 }
|
||||||
|
- name: per-page
|
||||||
|
in: query
|
||||||
|
schema: { type: integer, minimum: 1, maximum: 100, default: 20 }
|
||||||
|
- name: sort
|
||||||
|
in: query
|
||||||
|
schema: { type: string }
|
||||||
|
description: Префикс `-` для DESC. Поддерживается `ShopProductSearch::sort()`.
|
||||||
|
- name: title
|
||||||
|
in: query
|
||||||
|
schema: { type: string }
|
||||||
|
description: Поиск по подстроке в названии.
|
||||||
|
- name: status_id
|
||||||
|
in: query
|
||||||
|
schema: { type: integer }
|
||||||
|
description: По умолчанию `Status::ACTIVE=1`.
|
||||||
|
- name: category_id
|
||||||
|
in: query
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Список товаров
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductList'
|
||||||
|
403:
|
||||||
|
description: Нет права `shop-items` или флаг `enableShop` выключен.
|
||||||
|
|
||||||
|
/admin/shop/product/items:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Лёгкий справочник активных товаров
|
||||||
|
description: |
|
||||||
|
Возвращает только `{id, title}` для использования в фильтрах админ-страниц
|
||||||
|
(например, фильтр по товару на странице обработки заказов). Доступно
|
||||||
|
дополнительно роли `shop-orders`.
|
||||||
|
operationId: adminShopProductItems
|
||||||
|
parameters:
|
||||||
|
- name: title
|
||||||
|
in: query
|
||||||
|
schema: { type: string }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Справочник
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
data:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid }
|
||||||
|
title: { type: string }
|
||||||
|
_meta:
|
||||||
|
$ref: '#/components/schemas/_meta'
|
||||||
|
|
||||||
|
/admin/shop/product/view:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Карточка товара (admin)
|
||||||
|
operationId: adminShopProductView
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Товар
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProduct'
|
||||||
|
400:
|
||||||
|
description: Параметр `id` имеет некорректный формат.
|
||||||
|
404:
|
||||||
|
description: Товар не найден.
|
||||||
|
|
||||||
|
/admin/shop/product/create:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Создать товар вместе с опциями
|
||||||
|
description: |
|
||||||
|
Сохраняет товар и массив его опций одной транзакцией. Опции, отсутствующие
|
||||||
|
в `ShopProductOption[]`, помечаются `status_id = DELETED`.
|
||||||
|
|
||||||
|
Сначала валидируется товар; затем сохраняется с `refresh()` (чтобы
|
||||||
|
вернуть defaults из БД); затем сохраняются опции (валидируется на
|
||||||
|
save — `shop_product_id` имеет правило `exist`, которое отрабатывает
|
||||||
|
только после insert товара).
|
||||||
|
operationId: adminShopProductCreate
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductSaveRequest'
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Сохранённый товар
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProduct'
|
||||||
|
422:
|
||||||
|
description: Ошибка валидации — пустой `ShopProductOption[]` или валидация модели не прошла.
|
||||||
|
|
||||||
|
/admin/shop/product/update:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Обновить товар вместе с опциями
|
||||||
|
operationId: adminShopProductUpdate
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductSaveRequest'
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Обновлённый товар
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProduct'
|
||||||
|
404: { description: Товар не найден. }
|
||||||
|
422: { description: Ошибка валидации. }
|
||||||
|
|
||||||
|
/admin/shop/product/delete:
|
||||||
|
delete:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Soft-delete товара
|
||||||
|
description: |
|
||||||
|
Через override `BaseModel::deleteAll → softDeleteAll`. Физического удаления
|
||||||
|
записи не происходит — переводится в `status_id = DELETED`.
|
||||||
|
operationId: adminShopProductDelete
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
204: { description: Удалено. }
|
||||||
|
400: { description: Параметр `id` имеет некорректный формат. }
|
||||||
|
404: { description: Товар не найден. }
|
||||||
|
|
||||||
|
/admin/shop/product/export-excel:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Поставить задачу на excel-экспорт списка товаров
|
||||||
|
description: Файл готовится асинхронно — статус смотреть через `/file-processing/view`.
|
||||||
|
operationId: adminShopProductExportExcel
|
||||||
|
requestBody:
|
||||||
|
required: false
|
||||||
|
content:
|
||||||
|
application/x-www-form-urlencoded:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
additionalProperties: true
|
||||||
|
responses:
|
||||||
|
200: { description: Задача поставлена. }
|
||||||
|
|
||||||
|
/admin/shop/product/view-category:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Получить категорию товаров магазина
|
||||||
|
description: |
|
||||||
|
Реюз legacy `app\custom\actions\category\ViewAction`, параметризованного
|
||||||
|
`CategoryRoot::ROOT_SHOP_PRODUCT`.
|
||||||
|
operationId: adminShopProductViewCategory
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Категория
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/HttpJsonResult'
|
||||||
|
|
||||||
|
/admin/shop/product/update-category:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Создать/обновить категорию товаров магазина
|
||||||
|
operationId: adminShopProductUpdateCategory
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: false
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
description: Без `id` — создание; с `id` — обновление.
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
additionalProperties: true
|
||||||
|
description: Поля категории (title, parent_id, image и т.д. — см. CatalogManager).
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Категория
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/HttpJsonResult'
|
||||||
|
201:
|
||||||
|
description: Создана.
|
||||||
|
|
||||||
|
/admin/shop/product/delete-category:
|
||||||
|
delete:
|
||||||
|
tags: [admin-shop-product]
|
||||||
|
summary: Удалить категорию товаров магазина
|
||||||
|
operationId: adminShopProductDeleteCategory
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
204: { description: Удалено. }
|
||||||
|
400: { description: Параметр `id` имеет некорректный формат. }
|
||||||
|
|
||||||
|
/admin/shop/product-option:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-product-option]
|
||||||
|
summary: Варианты товара (admin)
|
||||||
|
description: |
|
||||||
|
`shop_product_id` обязателен — его требует `ShopProductOptionSearch`.
|
||||||
|
Дефолтная сортировка `sort_index ASC` через `defaultOrder` search-модели.
|
||||||
|
По умолчанию отдаются только активные (status_id=ACTIVE); чтобы увидеть удалённые — явно передать `status_id`.
|
||||||
|
operationId: adminShopProductOptionIndex
|
||||||
|
parameters:
|
||||||
|
- name: shop_product_id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
- name: status_id
|
||||||
|
in: query
|
||||||
|
schema: { type: integer }
|
||||||
|
- name: name
|
||||||
|
in: query
|
||||||
|
description: LIKE-фильтр по названию варианта.
|
||||||
|
schema: { type: string }
|
||||||
|
- name: sort
|
||||||
|
in: query
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum: [sort_index, "-sort_index", name, "-name", created_at, "-created_at"]
|
||||||
|
- name: per-page
|
||||||
|
in: query
|
||||||
|
schema: { type: integer, minimum: 1, maximum: 100, default: 100 }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Список опций
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductOptionList'
|
||||||
|
|
||||||
|
/admin/shop/product-option/view:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-product-option]
|
||||||
|
summary: Одна опция
|
||||||
|
operationId: adminShopProductOptionView
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Опция
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductOption'
|
||||||
|
404: { description: Опция не найдена. }
|
||||||
|
|
||||||
|
/admin/shop/product-option/create:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-product-option]
|
||||||
|
summary: Создать одну опцию
|
||||||
|
description: |
|
||||||
|
Для пакетного сохранения опций вместе с товаром — `POST /admin/shop/product/update`.
|
||||||
|
Этот эндпоинт нужен для точечных операций.
|
||||||
|
operationId: adminShopProductOptionCreate
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductOptionSaveRequest'
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Созданная опция
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductOption'
|
||||||
|
|
||||||
|
/admin/shop/product-option/update:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-product-option]
|
||||||
|
summary: Обновить одну опцию
|
||||||
|
description: |
|
||||||
|
Поле `shop_product_id` игнорируется — привязку к товару менять нельзя.
|
||||||
|
operationId: adminShopProductOptionUpdate
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductOptionSaveRequest'
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Обновлённая опция
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductOption'
|
||||||
|
404: { description: Опция не найдена. }
|
||||||
|
|
||||||
|
/admin/shop/product-option/delete:
|
||||||
|
delete:
|
||||||
|
tags: [admin-shop-product-option]
|
||||||
|
summary: Soft-delete опции
|
||||||
|
operationId: adminShopProductOptionDelete
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
204: { description: Удалено. }
|
||||||
|
404: { description: Опция не найдена. }
|
||||||
|
|
||||||
|
/admin/shop/order:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-order]
|
||||||
|
summary: Список заказов (admin)
|
||||||
|
operationId: adminShopOrderIndex
|
||||||
|
parameters:
|
||||||
|
- name: page
|
||||||
|
in: query
|
||||||
|
schema: { type: integer, minimum: 1, default: 1 }
|
||||||
|
- name: per-page
|
||||||
|
in: query
|
||||||
|
schema: { type: integer, minimum: 1, maximum: 100, default: 20 }
|
||||||
|
- name: order_status_id
|
||||||
|
in: query
|
||||||
|
schema: { type: integer }
|
||||||
|
description: |
|
||||||
|
Статусы заказа из `ShopOrderStatus`: 1=NEW, 2=PROCESSED,
|
||||||
|
3=CANCELED_MANAGER, 4=CANCELED_USER.
|
||||||
|
- name: created_user_id
|
||||||
|
in: query
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
- name: approver_user_id
|
||||||
|
in: query
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
- name: shop_item_id
|
||||||
|
in: query
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
description: Фильтр по товару (через JOIN на shopCart).
|
||||||
|
- name: created_at
|
||||||
|
in: query
|
||||||
|
schema: { type: string }
|
||||||
|
description: Диапазон `<начало>|<конец>` в формате `yyyy-MM-dd`.
|
||||||
|
- name: sort
|
||||||
|
in: query
|
||||||
|
description: |
|
||||||
|
Поддерживаемые поля: `created_at`, `num`, `order_status_id`,
|
||||||
|
`sum_cart_for_sorting`, `count_cart_for_sorting`.
|
||||||
|
Префикс `-` — сортировка по убыванию. Дефолт — `-created_at`.
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- created_at
|
||||||
|
- "-created_at"
|
||||||
|
- num
|
||||||
|
- "-num"
|
||||||
|
- order_status_id
|
||||||
|
- "-order_status_id"
|
||||||
|
- sum_cart_for_sorting
|
||||||
|
- "-sum_cart_for_sorting"
|
||||||
|
- count_cart_for_sorting
|
||||||
|
- "-count_cart_for_sorting"
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Список заказов
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopOrderList'
|
||||||
|
|
||||||
|
/admin/shop/order/view:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-order]
|
||||||
|
summary: Детализация заказа
|
||||||
|
operationId: adminShopOrderView
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Заказ с расширенным составом (shopCart)
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopOrder'
|
||||||
|
|
||||||
|
/admin/shop/order/process:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-order]
|
||||||
|
summary: Подтвердить заказ менеджером
|
||||||
|
description: |
|
||||||
|
Переводит заказ из STATUS_NEW в STATUS_PROCESSED. Если есть позиции
|
||||||
|
с `status_id = DELETED` — возвращает их количество на склад и проводит
|
||||||
|
refund-транзакцию на сумму отменённых позиций.
|
||||||
|
|
||||||
|
Внутри транзакции: `lock()` + `refresh()` + повторная проверка статуса
|
||||||
|
NEW — защита от race condition двойного refund.
|
||||||
|
operationId: adminShopOrderProcess
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopOrderActionRequest'
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Заказ обработан
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/HttpJsonResult'
|
||||||
|
422:
|
||||||
|
description: |
|
||||||
|
Ошибка валидации формы либо заказ уже не в статусе NEW
|
||||||
|
(`ShopOrderException::ALREADY_PROCESSED`).
|
||||||
|
|
||||||
|
/admin/shop/order/cancel:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-order]
|
||||||
|
summary: Отменить заказ менеджером
|
||||||
|
description: |
|
||||||
|
Переводит заказ в STATUS_CANCELED_MANAGER, возвращает все позиции
|
||||||
|
на склад и проводит полный refund баланса покупателя. Уведомляет
|
||||||
|
покупателя об отмене.
|
||||||
|
operationId: adminShopOrderCancel
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopOrderActionRequest'
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Заказ отменён
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/HttpJsonResult'
|
||||||
|
422:
|
||||||
|
description: Заказ уже не в статусе NEW или другая ошибка валидации.
|
||||||
|
|
||||||
|
/admin/shop/order/position-remove:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-order]
|
||||||
|
summary: Удалить позицию заказа
|
||||||
|
description: |
|
||||||
|
Операция допустима только на заказе в статусе NEW; для обработанного/отменённого — 422.
|
||||||
|
operationId: adminShopOrderPositionRemove
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
required: [id, comment]
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid, description: ID позиции (ShopCart). }
|
||||||
|
comment: { type: string, description: Причина удаления. }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Результат
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/HttpJsonResult'
|
||||||
|
404: { description: Позиция не найдена. }
|
||||||
|
422: { description: Ошибка валидации формы либо заказ уже не в статусе NEW. }
|
||||||
|
|
||||||
|
/admin/shop/order/position-restore:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-order]
|
||||||
|
summary: Восстановить удалённую позицию заказа
|
||||||
|
description: |
|
||||||
|
Операция допустима только на заказе в статусе NEW; для обработанного/отменённого — 422.
|
||||||
|
operationId: adminShopOrderPositionRestore
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
required: [id]
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Результат
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/HttpJsonResult'
|
||||||
|
400: { description: Параметр `id` не передан или имеет некорректный формат. }
|
||||||
|
404: { description: Позиция не найдена. }
|
||||||
|
422: { description: Заказ уже не в статусе NEW. }
|
||||||
|
|
||||||
|
/admin/shop/order/position-change-comment:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-order]
|
||||||
|
summary: Изменить комментарий к позиции заказа
|
||||||
|
description: |
|
||||||
|
Операция допустима только на заказе в статусе NEW; для обработанного/отменённого — 422.
|
||||||
|
operationId: adminShopOrderPositionChangeComment
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
required: [id, comment]
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid }
|
||||||
|
comment: { type: string }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Результат
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/HttpJsonResult'
|
||||||
|
404: { description: Позиция не найдена. }
|
||||||
|
422: { description: Ошибка валидации формы либо заказ уже не в статусе NEW. }
|
||||||
|
|
||||||
|
/admin/shop/order/export-excel:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-order]
|
||||||
|
summary: Поставить задачу на excel-экспорт списка заказов
|
||||||
|
description: Файл готовится асинхронно — статус смотреть через `/file-processing/view`.
|
||||||
|
operationId: adminShopOrderExportExcel
|
||||||
|
requestBody:
|
||||||
|
required: false
|
||||||
|
content:
|
||||||
|
application/x-www-form-urlencoded:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
additionalProperties: true
|
||||||
|
responses:
|
||||||
|
200: { description: Задача поставлена. }
|
||||||
|
|
||||||
|
/admin/shop/delivery-address:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-delivery-address]
|
||||||
|
summary: Список адресов доставки
|
||||||
|
operationId: adminShopDeliveryAddressIndex
|
||||||
|
parameters:
|
||||||
|
- name: page
|
||||||
|
in: query
|
||||||
|
schema: { type: integer, minimum: 1, default: 1 }
|
||||||
|
- name: per-page
|
||||||
|
in: query
|
||||||
|
schema: { type: integer, minimum: 1, maximum: 100, default: 20 }
|
||||||
|
- name: title
|
||||||
|
in: query
|
||||||
|
schema: { type: string }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Список
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopDeliveryAddressList'
|
||||||
|
|
||||||
|
/admin/shop/delivery-address/view:
|
||||||
|
get:
|
||||||
|
tags: [admin-shop-delivery-address]
|
||||||
|
summary: Один адрес
|
||||||
|
operationId: adminShopDeliveryAddressView
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Адрес
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopDeliveryAddress'
|
||||||
|
|
||||||
|
/admin/shop/delivery-address/create:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-delivery-address]
|
||||||
|
summary: Создать адрес
|
||||||
|
operationId: adminShopDeliveryAddressCreate
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
required: [title]
|
||||||
|
properties:
|
||||||
|
title: { type: string, maxLength: 255 }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Адрес
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopDeliveryAddress'
|
||||||
|
|
||||||
|
/admin/shop/delivery-address/update:
|
||||||
|
post:
|
||||||
|
tags: [admin-shop-delivery-address]
|
||||||
|
summary: Обновить адрес
|
||||||
|
operationId: adminShopDeliveryAddressUpdate
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
required: [title]
|
||||||
|
properties:
|
||||||
|
title: { type: string, maxLength: 255 }
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Адрес
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/AdminShopDeliveryAddress'
|
||||||
|
|
||||||
|
/admin/shop/delivery-address/delete:
|
||||||
|
delete:
|
||||||
|
tags: [admin-shop-delivery-address]
|
||||||
|
summary: Удалить адрес
|
||||||
|
description: |
|
||||||
|
Hard-delete (у модели нет soft-delete-цепочки). На исторические заказы
|
||||||
|
удаление не влияет — `ShopOrder.delivery_address` хранит текстовую копию.
|
||||||
|
operationId: adminShopDeliveryAddressDelete
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: query
|
||||||
|
required: true
|
||||||
|
schema: { type: string, format: uuid }
|
||||||
|
responses:
|
||||||
|
204: { description: Удалено. }
|
||||||
|
404: { description: Не найден. }
|
||||||
|
|
||||||
components:
|
components:
|
||||||
securitySchemes:
|
securitySchemes:
|
||||||
SessionAuth:
|
SessionAuth:
|
||||||
@@ -14013,6 +14732,252 @@ components:
|
|||||||
$ref: '#/components/schemas/GoalItem'
|
$ref: '#/components/schemas/GoalItem'
|
||||||
description: Цели которые не были обработаны
|
description: Цели которые не были обработаны
|
||||||
|
|
||||||
|
# ============================================================
|
||||||
|
# Admin Shop API (H-2626)
|
||||||
|
# ============================================================
|
||||||
|
|
||||||
|
HttpJsonResult:
|
||||||
|
type: object
|
||||||
|
description: |
|
||||||
|
Стандартная обёртка ответа: `app\logic\core\Entities\HttpJsonResult`.
|
||||||
|
properties:
|
||||||
|
success: { type: boolean }
|
||||||
|
data:
|
||||||
|
oneOf:
|
||||||
|
- { type: object, additionalProperties: true }
|
||||||
|
- { type: 'null' }
|
||||||
|
errors:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
field: { type: string }
|
||||||
|
message: { type: string }
|
||||||
|
message:
|
||||||
|
type: object
|
||||||
|
nullable: true
|
||||||
|
properties:
|
||||||
|
type:
|
||||||
|
type: string
|
||||||
|
enum: [success, info, warning, error]
|
||||||
|
text: { type: string }
|
||||||
|
|
||||||
|
AdminShopProduct:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid }
|
||||||
|
created_at: { type: string }
|
||||||
|
updated_at: { type: string }
|
||||||
|
status_id:
|
||||||
|
type: integer
|
||||||
|
description: 1=Active, 2=Inactive, 3=Deleted
|
||||||
|
preview_file_id: { type: string, format: uuid, nullable: true }
|
||||||
|
title: { type: string }
|
||||||
|
description: { type: string, nullable: true }
|
||||||
|
price: { type: integer }
|
||||||
|
createdAt: { type: string, description: Локализованная дата для UI. }
|
||||||
|
statusName: { type: string }
|
||||||
|
totalCount:
|
||||||
|
type: integer
|
||||||
|
description: Сумма `count` по всем активным опциям.
|
||||||
|
preview: { type: string, description: URL ресайз-превью. }
|
||||||
|
images:
|
||||||
|
type: array
|
||||||
|
items: { type: object, additionalProperties: true }
|
||||||
|
options:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductOption'
|
||||||
|
entityId: { type: integer, description: 405 (ShopProduct в Entity.php). }
|
||||||
|
# forView=true:
|
||||||
|
content: { type: object, additionalProperties: true, description: JSON-блоки EditorJS. }
|
||||||
|
categoriesName: { type: object, additionalProperties: true }
|
||||||
|
categoriesText: { type: string, nullable: true }
|
||||||
|
|
||||||
|
AdminShopProductList:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
data:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/AdminShopProduct'
|
||||||
|
_links:
|
||||||
|
$ref: '#/components/schemas/_links'
|
||||||
|
_meta:
|
||||||
|
$ref: '#/components/schemas/_meta'
|
||||||
|
|
||||||
|
AdminShopProductSaveRequest:
|
||||||
|
type: object
|
||||||
|
required: [title, price, options]
|
||||||
|
properties:
|
||||||
|
title: { type: string }
|
||||||
|
description: { type: string }
|
||||||
|
price: { type: integer, minimum: 0, maximum: 999999 }
|
||||||
|
preview_file_id: { type: string, format: uuid, nullable: true }
|
||||||
|
status_id: { type: integer }
|
||||||
|
options:
|
||||||
|
type: array
|
||||||
|
minItems: 1
|
||||||
|
description: |
|
||||||
|
Полный массив опций товара. Опции, отсутствующие в массиве, помечаются
|
||||||
|
`status_id = DELETED`. Для существующих опций передаётся `id`.
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
required: [name, count, price]
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid, description: Для обновления существующей опции. }
|
||||||
|
name: { type: string, maxLength: 128 }
|
||||||
|
count: { type: integer, minimum: 0, maximum: 999999 }
|
||||||
|
price: { type: integer, minimum: 0, maximum: 999999 }
|
||||||
|
preview_file_id: { type: string, format: uuid, nullable: true }
|
||||||
|
images:
|
||||||
|
type: array
|
||||||
|
items: { type: object, additionalProperties: true }
|
||||||
|
images:
|
||||||
|
oneOf:
|
||||||
|
- { type: array, items: { type: object, additionalProperties: true } }
|
||||||
|
- { type: string, description: JSON-encoded массив (legacy). }
|
||||||
|
content:
|
||||||
|
oneOf:
|
||||||
|
- { type: object, additionalProperties: true }
|
||||||
|
- { type: string, description: JSON-encoded блоки (legacy). }
|
||||||
|
categoriesId:
|
||||||
|
type: string
|
||||||
|
description: |
|
||||||
|
Список UUID категорий через запятую (например `uuid1,uuid2`).
|
||||||
|
Обрабатывается `CategoryTreeItemModelBehavior::afterSave`. Пустая строка
|
||||||
|
снимает все привязки. Без категории товар не будет виден в витрине покупателя.
|
||||||
|
|
||||||
|
AdminShopProductOption:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid }
|
||||||
|
created_at: { type: string }
|
||||||
|
updated_at: { type: string }
|
||||||
|
shop_product_id: { type: string, format: uuid }
|
||||||
|
status_id: { type: integer }
|
||||||
|
sort_index: { type: integer }
|
||||||
|
name: { type: string }
|
||||||
|
count: { type: integer }
|
||||||
|
price: { type: integer }
|
||||||
|
preview_file_id: { type: string, format: uuid, nullable: true }
|
||||||
|
images:
|
||||||
|
type: array
|
||||||
|
items: { type: object, additionalProperties: true }
|
||||||
|
entityId: { type: integer }
|
||||||
|
|
||||||
|
AdminShopProductOptionList:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
data:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/AdminShopProductOption'
|
||||||
|
_links:
|
||||||
|
$ref: '#/components/schemas/_links'
|
||||||
|
_meta:
|
||||||
|
$ref: '#/components/schemas/_meta'
|
||||||
|
|
||||||
|
AdminShopProductOptionSaveRequest:
|
||||||
|
type: object
|
||||||
|
description: |
|
||||||
|
Поля `id`, `created_user_id`, `updated_user_id`, `tenant_id` подставляются
|
||||||
|
автоматически behavior'ами модели — попытка передать их в payload
|
||||||
|
перезаписывается серверными значениями.
|
||||||
|
При `update` поле `shop_product_id` игнорируется — привязку к товару менять нельзя.
|
||||||
|
properties:
|
||||||
|
shop_product_id: { type: string, format: uuid }
|
||||||
|
status_id: { type: integer }
|
||||||
|
sort_index: { type: integer }
|
||||||
|
name: { type: string, maxLength: 128 }
|
||||||
|
count: { type: integer, minimum: 0, maximum: 999999 }
|
||||||
|
price: { type: integer, minimum: 0, maximum: 999999 }
|
||||||
|
preview_file_id: { type: string, format: uuid, nullable: true }
|
||||||
|
images:
|
||||||
|
type: array
|
||||||
|
items: { type: object, additionalProperties: true }
|
||||||
|
|
||||||
|
AdminShopOrder:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid }
|
||||||
|
created_at: { type: string }
|
||||||
|
updated_at: { type: string }
|
||||||
|
created_user_id: { type: string, format: uuid, description: Покупатель. }
|
||||||
|
approver_user_id: { type: string, format: uuid, nullable: true, description: Менеджер-аппрувер. }
|
||||||
|
num: { type: integer, description: Номер заказа. }
|
||||||
|
order_status_id:
|
||||||
|
type: integer
|
||||||
|
enum: [1, 2, 3, 4]
|
||||||
|
description: 1=NEW, 2=PROCESSED, 3=CANCELED_MANAGER, 4=CANCELED_USER
|
||||||
|
delivery_address: { type: string, nullable: true }
|
||||||
|
count_cart_for_sorting: { type: integer }
|
||||||
|
sum_cart_for_sorting: { type: integer }
|
||||||
|
createdAt: { type: string, description: Локализованная дата. }
|
||||||
|
orderStatusName: { type: string }
|
||||||
|
countCartPositions: { type: integer }
|
||||||
|
countCartTotal: { type: integer }
|
||||||
|
sumCart: { type: integer }
|
||||||
|
user:
|
||||||
|
type: object
|
||||||
|
additionalProperties: true
|
||||||
|
description: Профиль покупателя.
|
||||||
|
entityId: { type: integer, description: 406 (ShopOrder в Entity.php). }
|
||||||
|
# forView=true expand:
|
||||||
|
shopCart:
|
||||||
|
type: array
|
||||||
|
description: Состав заказа.
|
||||||
|
items:
|
||||||
|
type: object
|
||||||
|
additionalProperties: true
|
||||||
|
orderContent:
|
||||||
|
type: string
|
||||||
|
description: Форматированный текст состава заказа.
|
||||||
|
|
||||||
|
AdminShopOrderList:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
data:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/AdminShopOrder'
|
||||||
|
_links:
|
||||||
|
$ref: '#/components/schemas/_links'
|
||||||
|
_meta:
|
||||||
|
$ref: '#/components/schemas/_meta'
|
||||||
|
|
||||||
|
AdminShopOrderActionRequest:
|
||||||
|
type: object
|
||||||
|
required: [id]
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid, description: ID заказа. }
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
maxLength: 512
|
||||||
|
description: Комментарий к действию (сохраняется как Comment к заказу).
|
||||||
|
|
||||||
|
AdminShopDeliveryAddress:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
id: { type: string, format: uuid }
|
||||||
|
created_at: { type: string }
|
||||||
|
updated_at: { type: string }
|
||||||
|
created_user_id: { type: string, format: uuid }
|
||||||
|
updated_user_id: { type: string, format: uuid, nullable: true }
|
||||||
|
title: { type: string, maxLength: 255 }
|
||||||
|
|
||||||
|
AdminShopDeliveryAddressList:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
data:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/AdminShopDeliveryAddress'
|
||||||
|
_links:
|
||||||
|
$ref: '#/components/schemas/_links'
|
||||||
|
_meta:
|
||||||
|
$ref: '#/components/schemas/_meta'
|
||||||
|
|
||||||
security:
|
security:
|
||||||
- SessionAuth: [ ]
|
- SessionAuth: [ ]
|
||||||
- ApiKeyAuth: [ ]
|
- ApiKeyAuth: [ ]
|
||||||
|
|||||||
Reference in New Issue
Block a user