Характеристики

Характеристики товаров (например, «Цвет», «Размер») с локализованным названием и описанием; их значения задаются в разделе значений характеристик.

Метод	Адрес	Назначение
GET	`/company/product/specification`	Список характеристик
GET	`/company/product/specification/{model}`	Просмотр характеристики
POST	`/company/product/specification`	Создать характеристику
PUT	`/company/product/specification/{model}`	Изменить характеристику
DELETE	`/company/product/specification/{model}`	Удалить характеристику
DELETE	`/company/product/specification/{value}/restore`	Восстановить характеристику

Список характеристик

GET/company/product/specification

Характеристики товаров со значениями (options). Фильтры: name (локализованный поиск), company_id, created_at.

Заголовки

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

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

Параметр	Описание
`filter[id]`	ID — точное значение
`filter[company_id]`	Компания — точное значение
`filter[name]`	Название — поиск по части строки
`filter[created_at]`	Создано — период: `[0]` — с, `[1]` — по (`Y-m-d`)
`sort[]`	Сортировка, `-` — по убыванию: `id`, `-id`
`with[]`	Подгрузить связи: `company`, `options`
`page`	Номер страницы, с 1
`page-size`	Записей на странице, не больше 20

http

GET /company/product/specification?filter[id]=1&filter[name]=specification&filter[created_at][0]=2026-09-29&filter[created_at][1]=2026-09-30

Ответ · 200

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

Поля ответа

Поле	Тип	Описание
`data`	object[]	Данные
`data[].id`	integer	ID
`data[].company_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,
            "company_id": 1,
            "name": {
                "oz": "Specification 1 oz",
                "ru": "Specification 1 ru",
                "uz": "Specification 1 uz"
            },
            "description": {
                "oz": "Description 1 oz",
                "ru": "Description 1 ru",
                "uz": "Description 1 uz"
            },
            "created_at": "2026-09-30 12:47:59",
            "updated_at": "2026-09-30 12:47:59",
            "is_deleted": false
        }
    ],
    "links": {
        "first": "https://api.wasyt.uz/company/product/specification?page=1",
        "last": "https://api.wasyt.uz/company/product/specification?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/company/product/specification",
        "per_page": 20,
        "to": 1,
        "total": 1
    }
}

Просмотр характеристики

GET/company/product/specification/{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
`company_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,
    "company_id": 1,
    "name": {
        "oz": "Specification 1 oz",
        "ru": "Specification 1 ru",
        "uz": "Specification 1 uz"
    },
    "description": {
        "oz": "Description 1 oz",
        "ru": "Description 1 ru",
        "uz": "Description 1 uz"
    },
    "created_at": "2026-09-30 12:47:59",
    "updated_at": "2026-09-30 12:47:59",
    "is_deleted": false
}

Создать характеристику

POST/company/product/specification

Создаёт характеристику с уникальным названием и необязательным описанием на трёх языках (ru, uz, oz).

Заголовки

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

Тело запроса

Поле	Тип	Обязательно	Описание
`name.{lang}`	string	Да	Название. Макс. 255 символов. Уникальное значение в компании
`description.{lang}`	string	Нет	Описание

JSONcURL

json

{
    "name": {
        "ru": "Specification 3 ru",
        "uz": "Specification 3 uz",
        "oz": "Specification 3 oz"
    },
    "description": {
        "ru": "Description 3 ru",
        "uz": "Description 3 uz",
        "oz": "Description 3 oz"
    }
}

bash

curl -X POST "https://api.wasyt.uz/company/product/specification" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"name":{"ru":"Specification 3 ru","uz":"Specification 3 uz","oz":"Specification 3 oz"},"description":{"ru":"Description 3 ru","uz":"Description 3 uz","oz":"Description 3 oz"}}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
`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	Создано
`company_id`	integer	Компания
`id`	integer	ID
`is_deleted`	boolean

json

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

Изменить характеристику

PUT/company/product/specification/{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 записи

Тело запроса

Поле	Тип	Обязательно	Описание
`name.{lang}`	string	Да	Название. Макс. 255 символов. Уникальное значение в компании
`description.{lang}`	string	Нет	Описание

JSONcURL

json

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

bash

curl -X PUT "https://api.wasyt.uz/company/product/specification/1" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"name":{"ru":"Specification 1 ru","uz":"Specification 1 uz","oz":"Specification 1 oz"},"description":{"ru":"Description 1 ru","uz":"Description 1 uz","oz":"Description 1 oz"}}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
`id`	integer	ID
`company_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,
    "company_id": 1,
    "name": {
        "ru": "Specification 1 ru",
        "uz": "Specification 1 uz",
        "oz": "Specification 1 oz"
    },
    "description": {
        "ru": "Description 1 ru",
        "uz": "Description 1 uz",
        "oz": "Description 1 oz"
    },
    "created_at": "2026-09-30 12:47:59",
    "updated_at": "2026-09-30 12:52:51",
    "is_deleted": false
}

Удалить характеристику

DELETE/company/product/specification/{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/company/product/specification/{value}/restore

Восстанавливает ранее удалённую характеристику по ID.

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