API для продавцов

Свой бот или склад: цены и наличие, загрузка товара для автовыдачи, заказы и отметка выдачи по ключу API. Пароль от аккаунта не нужен.

Ключ

Выпустите ключ в «Инструментах» и передавайте его в заголовке. Ключ показывается один раз. Если он утёк, отзовите его, и он сразу перестанет работать. До 5 ключей.

curl https://lutli.ru/api/v1/me \
  -H "Authorization: Bearer gm_live_…"

Не больше 60 запросов в минуту на ключ, сверх лимита ответ 429 и заголовок Retry-After. Каждый запрос 30 дней хранится в журнале «Инструментов».

Лоты

GET /api/v1/listings?status=active&limit=50&cursor=…
Свои лоты: цена (копейки строкой), наличие, статус, игра и раздел. Следующая страница по next.
PATCH /api/v1/listings/{id}
Поменять цену, наличие или снять и вернуть: {"price": "49000", "stock": 3, "status": "paused"}. Правила те же, что на сайте.
POST /api/v1/listings/{id}/stock
Склад автовыдачи: {"items": ["ключ или строка товара", …]}, до 500 за раз. Повторы и уже выданное пропускаются.

Заказы

GET /api/v1/orders?status=paid&since=2026-11-01T00:00:00Z
Свои продажи: номер, статус, сумма и сколько придёт вам, ник покупателя и его ответы на поля лота.
POST /api/v1/orders/{id}/start
«Взять в работу»: покупатель увидит отметку в заказе. У услуг со сроком в заказе есть serviceDueAt, срок выполнения.
POST /api/v1/orders/{id}/deliver
Отметить выдачу. С {"message": "…"} покупатель получит сообщение в чат заказа (контакты скрываются, как в чате).

Вебхук «оплачен новый заказ»

Задайте адрес (https) в «Инструментах» и получите секрет. На каждый оплаченный заказ придёт POST с JSON и заголовками:

X-GM-Event: order.paid
X-GM-Delivery: <delivery-id>
X-GM-Signature: sha256=<hmac_sha256(body, secret)>

{"event":"order.paid","createdAt":"…","data":{"id":"…","publicNumber":"GM-…",
 "listingId":"…","title":"…","qty":1,"amount":"49000","sellerPayout":"44100",
 "currency":"RUB","buyerData":[{"label":"Nick","value":"…"}],"autoDelivery":false}}

Проверяйте подпись: HMAC-SHA256 тела вашим секретом. Если ответ не 2xx или его нет 5 секунд, повторим через 1, 5, 30, 120, 360 мин.

API для продавцов · Lutli