К содержанию
Libermall для разработчиков

Ключи и права

Ключ показывается один раз, при создании. Храните его только на сервере — ни в приложении, ни в боте на стороне клиента, ни в репозитории. Отозвать ключ можно в кабинете в любой момент.

Где взять ключ

Кто выГде создатьЗаголовок
ПродавецКабинет продавца → API-ключиx-seller-api-key
Партнёр, покупаете по APIlibermall.com → Кабинет → APIx-buyer-api-key

Ключ продавца привязан к магазину — в запросах магазин не передаётся. Ключ покупателя привязан к аккаунту и тратит деньги его кошелька, поэтому выпустить его можно только с подтверждённой почтой, привязанным Telegram и включённой двухфакторной защитой — и с кодом 2FA при создании. Новый ключ заработает после подтверждения по ссылке из письма на почту (если аккаунт создан через Telegram — из сообщения бота в этот Telegram); до этого API отвечает 401. После смены почты или Telegram новый ключ можно выпустить через сутки. В письме есть кнопка «Это не я — отозвать ключ».

Права

Права выдаются по одному и работают «закрыто по умолчанию»: чего нет в ключе, того нет вовсе. Ключ без прав не может ничего. В ответе 403 написано, какого права не хватает.

Seller API

ПравоЧто открывает
products:readЧтение каталога, категорий, поставщиков
products:writeСоздание и изменение товаров, загрузка картинок
orders:readЗаказы магазина
orders:fulfillРучная выдача строки заказа
balance:readБаланс магазина
payouts:readВыплаты
reviews:readОтзывы
disputes:readСпоры

Buyer API

ПравоЧто открывает
buyer:catalog:readКаталог и карточки товаров
buyer:balance:readБаланс кошелька и история операций
buyer:orders:writeПокупка и адрес вебхука
buyer:orders:readЗаказы и их коды

Проверить ключ

Первый запрос с новым ключом — «кто я». Он показывает, какому магазину или аккаунту принадлежит ключ и какие у него права.

# продавец
curl https://api.libermall.com/admin/seller-api/me -H "x-seller-api-key: $LIBERMALL_API_KEY"

# партнёр
curl https://api.libermall.com/buyer-api/me -H "x-buyer-api-key: $LIBERMALL_BUYER_KEY"

Повторы без дублей

Каждый запрос на запись принимает заголовок Idempotency-Key — любую уникальную строку на одну операцию. Сеть может оборваться в любой момент: повторите запрос с тем же ключом, и вы получите исходный результат, а не второй товар или второе списание.

В Seller API заголовок обязателен на каждой записи (POST, PATCH). В Buyer API он обязателен для покупки и устроен так:

  • от 8 до 128 символов: латиница, цифры и . _ : -;
  • тот же ключ и то же тело — тот же заказ (200), второго списания нет;
  • тот же ключ, другое тело — 409 idempotency_conflict;
  • тот же ключ, пока первый запрос ещё выполняется — 409 in_flight, повторите чуть позже.

Ключ, которого вы не создавали

Такой ключ могла выпустить поддержка Libermall по вашему обращению — они помечены в кабинете. Если обращения не было, отзовите ключ и напишите нам.