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 мин.