Добавить личный параметр продавца (уровень A, без модерации, идемпотентный)

POST /v1/attributes/custom/add

POST/v1/attributes/custom/add

Создаёт кастомный атрибут продавца (без модерации). Доступен только этому продавцу на его карточках. Не показывается в шаблоне категории другим продавцам. Не индексируется в общих фильтрах.

Тело запроса

request_key
[ "string", "null" ]
Уникальный ключ идемпотентности (опционально). Если не передан - идемпотентность не гарантируется.
code
string
required
Универсальный код (уникален в рамках продавца). Напр. my_internal_sku
name
string
required
Название (для отображения продавцу)
description
[ "string", "null" ]
type
string
required
Тип данных значения:
  • string - произвольная строка
  • int - целое число
  • float - дробное число
  • enum - одно значение из справочника
  • multi - несколько значений из справочника
  • bool - да/нет
  • file - файл (изображение/документ)
  • ref - ссылка на сущность (бренд, категория, продавец)
  • color - цвет (UI: показывать свотчи, значения — enum с RGB)
  • size - размер (UI: показывать размерную сетку)
  • brand - бренд (UI: показывать выбор бренда)
Допустимые значения
stringintfloatenummultiboolfilerefcolorsizebrand
unit
max_count
[ "integer", "null" ]
max_length
[ "integer", "null" ]
values
[ "array", "null" ]
Справочник значений (опц., для enum/multi)
Показать свойства
Свойства не описаны

Успешный ответ

200Результат создания кастомного атрибута
application/json
object
request_key
[ "string", "null" ]
Ключ идемпотентности (эхо из запроса; пусто, если не передан)
attribute_id
string
required
code
string
required
status
string
required
Для кастомного - всегда active (без модерации)
Допустимые значения
pendingactiverejectedrevokeddisabled
created_at
string
required
idempotent
[ "boolean", "null" ]
error
Ошибка (например, code_conflict)
POST/v1/attributes/custom/add
1curl https://api.omninet.ru/v1/attributes/custom/add \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "request_key": "seller_67890_20260719_180000_internal_sku",6  "code": "my_internal_sku",7  "name": "Внутренний артикул продавца",8  "description": "Для учёта во внутренней системе продавца",9  "role": "property",10  "type": "string",11  "max_count": 1,12  "max_length": 10013}'
{
  "request_key": "seller_67890_20260719_180000_internal_sku",
  "attribute_id": "attr_custom_001",
  "code": "my_internal_sku",
  "status": "active",
  "created_at": "2026-07-19T18:00:00Z"
}

Результат создания кастомного атрибута