К содержанию
Libermall для разработчиков
Seller API › Первый товар

Первый товар за пять минут

Всё ниже — обычный HTTPS. Базовый адрес — https://api.libermall.com. Для каталога ключу хватит прав products:read и products:write. Для Node.js есть готовый пакет @libermall/shop-sdk.

1. Выпустите ключ

Кабинет продавца → API-ключи. Права выдаются по одному, секрет показывается ровно один раз. Подробно — ключи и права.

2. Проверьте, в какой магазин пишет ключ

Магазин определяется ключом — в запросах его нет. Если магазинов несколько, это единственный способ убедиться, что каталог поедет туда, куда вы думаете.

curl https://api.libermall.com/admin/seller-api/me \
  -H "x-seller-api-key: $LIBERMALL_API_KEY"

В ответе есть payout_verified. Если он false, витрина не покажет товары этого магазина, как бы они ни были опубликованы. Это самый частый ответ на «залил каталог, а на сайте пусто».

3. Возьмите категорию

Плоский список, у каждой строки есть parent_id — дерево собирается за один запрос.

curl https://api.libermall.com/admin/seller-api/categories \
  -H "x-seller-api-key: $LIBERMALL_API_KEY"

4. Создайте товар — сразу с обложкой

Ссылку на картинку можно давать свою: Libermall скачает её и положит к себе, поэтому обложка не пропадёт, если ваш адрес переедет. Отдельная загрузка нужна, только если картинки нигде не опубликованы.

curl -X POST https://api.libermall.com/admin/seller-api/products \
  -H "x-seller-api-key: $LIBERMALL_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Ключ активации",
    "delivery_type": "digital_instant",
    "category_id": "pcat_…",
    "thumbnail": "https://ваш-сайт/cover.png",
    "status": "published",
    "variants": [{ "title": "Стандарт",
      "prices": [{ "amount": 9.99, "currency_code": "usd" }] }]
  }'

Картинки: PNG, JPEG, WebP, GIF, до 5 МБ, до 10 на товар. Тип определяется по содержимому файла, а не по расширению. SVG не принимается.

5. Повторяйте безопасно

Idempotency-Key обязателен на каждой записи. Повтор с тем же ключом вернёт тот же товар, а не второй такой же — сеть может оборваться в любой момент, и это нормально.