Перейти к содержанию

Создать новое предложение

POST /api/v1/offers

Метод позволяет создать новое предложение.

Обязательные поля - title — Название предложения - description — Описание предложения - tags — Теги предложения - section — Категория предложения - catalog_path — Подкатегория предложения - age_rating — Возрастное ограничение предложения - price — Цена предложения

Добавить обложку

Обложка для предложения загружается отдельно после создания предложения.
Вам необходимо воспользоваться методом Добавить или обновить обложку предложения.

Добавить дополнительные медиафайлы

  1. Загрузить медиафайлы с помощью метода Загрузить медиафайл для предложения, метод возвращает список URI адресов загруженных медиафайлов.
  2. Добавить URI медиафайлов в поле gallery.

Категория и подкатегория предложения

Воспользуйтесь методом Получить категории и их подкатегории для получения ID подкатегории и правильного сопоставления с категорией.

Предложение из категории "Услуги"

section — 8

Доступ к публикации контента этой категории предоставляется через заявку в техническую поддержку.

Предложение c уникальными ключами

Предложение c уникальными ключами относятся к категориям (section): - Ключи активации — 3 - Купоны и развлечения — 12 - Подарочные сертификаты — 13

Обязательные данные: - Ключи к предложению - Инструкция по активации ключа

Загрузка ключей

Список ключей передается в параметре keys вашего запроса при создании предложения.
В дальнейшем вы можете добавлять ключи с помощью метода Добавить ключи активации.

Добавление инструкции по активации ключа

Инструкцию по активации ключа необходимо добавить в поле meta в формате JSON используя следующий пример.
Чтобы сделать текст более привлекательным и удобочитаемым, используйте перенос строки \n.

Пример:

{
    "meta":{
        "key_instruction": "Инструкция по активации\n1. Зайдите на сайт ...\n2.Вставьте ключ в поле ..."
    }
}

Предложение с контентом

Предложение с контентом относится к категориям (section): - Видеоконтент — 1 - Аудиоконтент — 2 - Электронные книги — 4 - Аудиокниги — 5 - Цифровые товары — 6

Обязательные данные: - Контент для предложения

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

Если вы ещё не добавили контент в личный кабинет продавца, то вы можете это сделать по инструкции.

Для добавления контента вам необходимо передать в параметре content список данных используя пример ниже.

Пример:

"content": [
    {
        "category_id": 1,
        "content": 8942
    },
    {
        "category_id": 1,
        "content": 4211
    }
]

где: - category_id — ID категории контента - content — ID контента

Эту информацию вы можете получить с помощью метод Получить список своего контента.

Максимум 50 запросов в секунду

Тело запроса: OfferCreateRequest

Ответ: OfferResponse

Примеры вызова

import os
from wildberries_sdk import wbd

token = os.getenv("WB_API_TOKEN")
api = wbd.DefaultApi(
    wbd.ApiClient(wbd.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.offer_create(offer_create_request=...)
print(result)

import { Configuration, DefaultApi } from 'wildberries-sdk';

const api = new DefaultApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.offerCreate({ ... });
console.log(result);

cfg := wbd.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := wbd.NewAPIClient(cfg)
result, _, err := client.DefaultApi.OfferCreate(context.Background()).Execute()

<?php
$config = Wildberries\Sdk\Wbd\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Wbd\Api\DefaultApi(new GuzzleHttp\Client(), $config);
$result = $api->offerCreate(...);

use wildberries_sdk_wbd::apis::{configuration::Configuration, configuration::ApiKey, default_api};

let mut config = Configuration::new();
config.api_key = Some(ApiKey { prefix: None, key: std::env::var("WB_API_TOKEN").unwrap() });
let result = default_api::offer_create(&config, ...).await?;