Первый товар за пять минут
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 обязателен на каждой записи. Повтор с тем же ключом вернёт тот же товар, а не второй такой же — сеть может оборваться в любой момент, и это нормально.