Добавить бренд (proposal на модерацию, идемпотентный)

POST /v1/brands/add

POST/v1/brands/add

Создаёт proposal на добавление бренда. Идемпотентность по request_key - повторный запрос с тем же ключом возвращает результат первого (без дублирования).

Жизненный цикл proposal:

  • pending - подан, ждёт модерации
  • approved - одобрен, бренд активен
  • rejected - отклонён (дубликат / нет торговой марки / некорректные данные)

Тело запроса

request_key
[ "string", "null" ]
Уникальный ключ идемпотентности (генерируется продавцом, опционально). Формат рекомендуется: {seller_id}_{timestamp}_{brand_slug} Повторный запрос с тем же ключом возвращает результат первого. Если не передан - идемпотентность не гарантируется.
name
string
required
Название бренда
slug
[ "string", "null" ]
URL-слаг (опц.; если пуст - генерируется из name)
logo_url
[ "string", "null" ]
country
[ "string", "null" ]
ISO 3166-1 alpha-2
website
[ "string", "null" ]

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

200Результат создания proposal
application/json
object
request_key
[ "string", "null" ]
Ключ идемпотентности (эхо из запроса; пусто, если не передан)
brand_id
string
required
status
string
required
Статус бренда:
  • pending - proposal подан, ждёт модерации
  • active - одобрен, доступен всем
  • rejected - отклонён (дубликат/неверное название)
  • revoked - отозван продавцом (через /v1/brands/revoke)
  • disabled - отключён модератором
Допустимые значения
pendingactiverejectedrevokeddisabled
created_at
string
required
idempotent
[ "boolean", "null" ]
true = идемпотентный повтор (тот же request_key)
matched_by
[ "string", "null" ]
Если найден дубликат - по какому полю (slug/name)
message
[ "string", "null" ]
Сообщение (для дубликата/идемпотентности)
POST/v1/brands/add
1curl https://api.omninet.ru/v1/brands/add \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "request_key": "seller_67890_20260719_154500_mebel_classic",6  "name": "Мебель-Классик",7  "slug": "mebel-classic",8  "country": "RU",9  "website": "https://mebel-classic.ru"10}'
{
  "request_key": "seller_67890_20260719_154500_mebel_classic",
  "brand_id": "brand_mebel_classic",
  "status": "pending",
  "created_at": "2026-07-19T15:45:00Z"
}

Результат создания proposal