Ключи и права
Где взять ключ
| Кто вы | Где создать | Заголовок |
|---|---|---|
| Продавец | Кабинет продавца → API-ключи | x-seller-api-key |
| Партнёр, покупаете по API | libermall.com → Кабинет → API | x-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 по вашему обращению — они помечены в кабинете. Если обращения не было, отзовите ключ и напишите нам.