Получить список proposals на общие атрибуты продавца

POST /v1/attributes/proposal/list

POST/v1/attributes/proposal/list

Список proposal-заявок (не результат обработки, а сами поданные заявки с их содержимым).

Тело запроса

filter
[ "object", "null" ]
Показать свойства
status
category_id
[ "string", "null" ]
request_keys
[ "array", "null" ]
pagination
object
Cursor-пагинация. Первый запрос - без cursor (или пустой). Для получения следующей страницы - передать cursor из ответа (pagination.next_cursor). Если has_next: false - достигнут конец списка.
Показать свойства
cursor
[ "string", "null" ]
Курсор для следующей страницы (opaque-токен, генерируется сервером). Пусто или отсутствие - первая страница.
limit
integer
required
Лимит элементов на странице

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

200Список
application/json
object
proposals
array
required
Элемент списка proposals (с полным содержимым заявки, не только статус)
Показать свойства
request_key
[ "string", "null" ]
proposal_id
string
required
category_id
[ "string", "null" ]
attribute
object
Описание предлагаемого атрибута
Показать свойства
code
string
required
Универсальный код (напр. fabric_density)
name
string
required
description
[ "string", "null" ]
role
string
required
Роль атрибута в карточке:
  • specification - потребительский (таблица спецификаций на витрине); описывает параметр SPU (одинаковый для всех SKU)
  • property - технический (внутренний, не показывается покупателю); описывает параметр SPU
  • variation - потребительский + описывает параметр SKU (отличает варианты внутри SPU): показывается в таблице спецификаций и кнопками выбора варианта; каждая комбинация значений variation-осей = отдельный SKU со своей ценой/штрихкодом/остатком
  • property_variation - технический + описывает параметр SKU (отличает варианты внутри SPU): не показывается покупателю, но используется для различения SKU
Допустимые значения
specificationpropertyvariationproperty_variation
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" ]
min_value
[ "number", "null" ]
max_value
[ "number", "null" ]
values
[ "array", "null" ]
Предлагаемые значения (если type=enum/multi; опц.)
Показать свойства
Свойства не описаны
justification
[ "string", "null" ]
status
string
required
Статус proposal:
  • pending - подан, ждёт модерации
  • approved - одобрен, атрибут добавлен в шаблон (создан attribute_id)
  • rejected - отклонён (дубликат / слишком специфичен)
Допустимые значения
pendingapprovedrejected
created_at
string
required
reviewed_at
[ "string", "null" ]
attribute_id
[ "string", "null" ]
ID созданного атрибута (если approved)
reject_reason
reject_comment
[ "string", "null" ]
pagination
object
required
Результат cursor-пагинации
Показать свойства
next_cursor
[ "string", "null" ]
Курсор для следующей страницы. Передать в pagination.cursor следующего запроса. Пусто (или null), если has_next: false (достигнут конец списка).
has_next
boolean
required
true - есть следующая страница; false - достигнут конец списка.
total
[ "integer", "null" ]
Общее количество элементов (опционально). Может быть неточным (приблизительная оценка на момент запроса). Не возвращается, если сервер не может оценить общее количество.
POST/v1/attributes/proposal/list
1curl https://api.omninet.ru/v1/attributes/proposal/list \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "status": null,7    "category_id": null,8    "request_keys": [9      "string"10    ]11  },12  "pagination": {13    "cursor": null,14    "limit": 10015  }16}'
{
  "proposals": [
    {
      "request_key": null,
      "proposal_id": "string",
      "category_id": null,
      "attribute": {
        "code": "string",
        "name": "string",
        "description": null,
        "role": "string",
        "type": "string",
        "unit": null,
        "max_count": 0,
        "max_length": 0,
        "min_value": null,
        "max_value": null,
        "values": [
          {
            "id": "string",
            "code": "red",
            "name": "красный",
            "slug": "red",
            "enabled": true,
            "rgb": null,
            "hex": "#FF0000",
            "image": null,
            "ref": null,
            "locales": [
              {
                "lang": "ru",
                "name": "красный"
              }
            ],
            "sort_order": null
          }
        ]
      },
      "justification": null,
      "status": "string",
      "created_at": "string",
      "reviewed_at": null,
      "attribute_id": null,
      "reject_reason": null,
      "reject_comment": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_next": true,
    "total": null
  }
}

Список