ПРОГРАММНЫЙ ДОСТУП

Публичный API

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

https://mawgli.men/api/v1

Отдельного адреса вида api.mawgli.men нет — все запросы идут сюда

МЕТОД	АДРЕС	ЧТО ДЕЛАЕТ	КЛЮЧ	ЛИМИТ
GET	/health	проверка ключа и связи	нужен	60/мин
GET	/categories	разделы каталога: число позиций и цена «от»	нужен	60/мин
GET	/products	каталог: артикул, название, остаток, цена, лот	нужен	60/мин
GET	/products/{id}	одна позиция целиком	нужен	60/мин
GET	/instant	только позиции мгновенной выдачи	нужен	60/мин
GET	/balance	остаток баланса и суммы по ключу	нужен	60/мин
GET	/orders	список заказов, страницами по 50	нужен	60/мин
GET	/orders/{id}	один заказ вместе с выдачей	нужен	60/мин
GET	/usage	счётчик запросов и последнее обращение по ключу	нужен	60/мин
POST	/orders	создать заказ и оплатить с баланса	нужен	60/мин
POST	/balance/topup	получить реквизиты пополнения	нужен	60/мин

Таблица прокручивается вбок: справа — колонки «Ключ» и «Лимит».

Как подключиться

Ключ и секрет создаются в кабинете. GET-запросам хватает ключа, POST-запросы — заказ и пополнение — принимаются только с подписью.

X-API-Key

ключ из кабинета, 32 символа

всегда

X-Timestamp

время в секундах (unix), расхождение с сервером — не больше 5 минут

для POST

X-Signature

HMAC-SHA256 по секрету от строки «timestamp, перевод строки, тело запроса»; одна подпись принимается один раз

для POST

curl https://mawgli.men/api/v1/products \
  -H "X-API-Key: 7f3a2c91b40e4dd6a810c5e2f19b7d34"

Коды ответа

200

в порядке

400

запрос отклонён: количество ниже минимальной партии, неподдерживаемая сеть или неверный параметр

401

ключ не передан, не принят или подпись не прошла проверку

402

не хватает баланса

403

IP-адрес не входит в белый список ключа

404

позиция или заказ не найдены

409

остатка не хватает или позицию держит другой покупатель

429

лимит исчерпан — повторите через столько секунд, сколько указано в Retry-After

501

оплата счётом пока не поддерживается — используйте payment_method balance

503

сервис или сеть временно недоступны — повторите позже

Лимиты

НЕ БОЛЬШЕ ЧЕМ

запросов в минуту на один ключ

Превышение отвечает кодом 429 с заголовком Retry-After — через столько секунд запрос можно повторить.

Что придёт в ответ

{
  "total": 6,
  "page": 1,
  "page_size": 50,
  "items": [
    {
      "sku": 200546,
      "title": "Instagram | Авторег API | Отлежка 4+ мес. | Рег. 03.2026 | 2FA",
      "category": "autoreg_aged",
      "quantity": 30,
      "min_quantity": 1,
      "price_usdt": 0.41,
      "instant_delivery": true,
      "instant_stock": 12
    }
  ]
}

Возврат по API-заказу — вручную

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

Попробовать прямо здесь

Запрос уходит из вашего браузера. Ключ на сервере не сохраняется.

КЛЮЧ

Сохраняется в sessionStorage на этом устройстве.

СЕКРЕТ

нужен только для подписи POST-запросов; сохраняется в sessionStorage на этом устройстве.

Эндпоинт

Запрос отправляется напрямую с вашего браузера. Ключ нигде не сохраняется на сервере.

Ответ

// выберите эндпоинт выше и нажмите «Выполнить»