market.add

Добавление товара

НазваниеОбязательныйТипОписание
gid Нет String

Идентификатор группы

type Да ApiProductOwnerType

Тип товара:

  • GROUP_PRODUCT - товар
  • GROUP_SUGGESTED - предложенный товар (товар на модерацию)
attachment Да Attachment

Контент товара в JSON

catalog_ids Нет String[]

Идентификаторы каталогов для добавления товара

devices Нет String[]

Платформа постинга

update_default_visibility Нет Boolean

Авторизация

Сессия обязательна

Необходимые права

  • GROUP_CONTENT
  • VALUABLE_ACCESS

Предусматривает строгий порядок медиаблоков в поле attachment - заголовок (текст), описание (текст, опционально), фото (опционально), специфичная для товара информация. У товара как минимум должно быть либо описание, либо фото. Например:

{"media":[
	{"type":"text","text":"Название товара"},
	{"type":"text","text":"Описание товара"},
	{
	    "type": "photo",
	    "list": [
	        {"id": "photoToken1"}, 
	        {"id": "photoToken2"}, 
	        {"existing_photo_id": "1234", "group": true}
	    ]
	},
	{"type":"product","price":1000,"lifetime": 30}
]}

Время публикации товара может быть указано: месяц (“lifetime”: 30), бессрочное (“lifetime”: 0). Если параметр lifetime не указан, то по-умолчанию срок публикации - месяц. На публичных страницах возможно размещение товаров как на месяц, так и и бессрочно. В группах же разрешены только товары с ограниченным сроком публикации.

По-умолчанию, валюта - российский рубль. Однако возможно указание другой валюты: USD, KZT, UAH, GEL, UZS, KGS, AZN, USD, EUR, BYN. Например, цена 10 долларов:

{"type":"product","price": 10, "currency": "USD", "lifetime": 30}

Если требуется задать ссылку на товар на внешнем сайте, можно воспользоваться полем partner_link в описании товара:

{"type":"product","price":1000,"lifetime": 30,"partner_link":"https://example.com"}

Загрузка фото происходит аналогично медиатопикам. В частности, метод commit после upload-а фото вызывать не нужно.

Тип

{ "product_id": "String", "success": "boolean" }

Параметры приложения

Данные о сессии пользователя

Метод

Список параметров

Используем для подписи secret_key = session_secret_key
Используем для подписи secret_key = application_secret_key
Используем для подписи secret_key = MD5(access_token + application_secret_key)
secret_key =
Сортируем и склеиваем параметры запроса и secret_key
Рассчитываем MD5 от полученной строки и получаем параметр sig