Mayzebuy API

Mayzebuy REST API

Официальный REST API магазина Mayzebuy для автоматизации продаж цифровых подписок ИИ, игровых ключей, мгновенной отправки Telegram Stars и Telegram Premium по юзернейму.

Базовый URL: http://api.mayzebuy.v6.navy/api
Авторизация: Header X-API-Key
Лимит: 60/мин
Формат: JSON
Авторизация

Каждый запрос к защищенным методам должен содержать персональный ключ в HTTP-заголовке X-API-Key. Получить или перевыпустить ключ можно в боте в разделе «API-ключ».

X-API-Key: Mayze_buy_your_secret_key_here
Лимиты запросов (Rate Limiting)

Для защиты сервера установлены лимиты частоты обращений:

Категория запросов Лимит Ответ при превышении
Информационные (GET: баланс, каталог, заказы) 60/мин HTTP 429 (заголовок Retry-After)
Покупки и услуги (POST: purchases, Stars, Premium) 15/мин HTTP 429 Too Many Requests

В ответе каждого запроса передаются заголовки X-RateLimit-Limit и X-RateLimit-Remaining.

Проверка баланса
GET /v1/balance

Возвращает текущий баланс в рублях и долларах, курс ЦБ и статус активности ключа.

cURL 
curl "http://api.mayzebuy.v6.navy/api/v1/balance"   -H "X-API-Key: Mayze_buy_YOUR_KEY"

Пример ответа (200 OK):

{
  "ok": true,
  "user_id": 1665600266,
  "balance_rub": 1500.0,
  "balance_usd": 16.3,
  "rate_usd_rub": 92.0,
  "currency": "RUB",
  "api_enabled": true
}
Каталог товаров и остатки
GET /v1/catalog

Возвращает категории и товары с ценами (RUB/USD) и количеством на складе (available_quantity).

cURL 
curl "http://api.mayzebuy.v6.navy/api/v1/catalog"   -H "X-API-Key: Mayze_buy_YOUR_KEY"

Пример ответа (200 OK):

{
  "ok": true,
  "store": "Mayzebuy",
  "categories": [
    {
      "id": 1,
      "name": "ChatGPT",
      "products": [
        {
          "id": 1,
          "name": "ChatGPT Plus (1 Месяц)",
          "price_rub": 669.0,
          "price_usd": 7.27,
          "available_quantity": 38,
          "delivery_type": "stock"
        }
      ]
    }
  ]
}
Информация о товаре
GET /v1/products/{product_id}

Получение информации по конкретному ID товара.

cURL 
curl "http://api.mayzebuy.v6.navy/api/v1/products/16"   -H "X-API-Key: Mayze_buy_YOUR_KEY"
Создание покупки (ИИ, Ключи, Подписки)
POST /v1/purchases

Списывает средства с баланса и моментально возвращает товар (аккаунт, промо-ссылку, ключ или куки).

Поле Тип Обязательное Описание
item_id integer Да ID товара из каталога (/v1/catalog)
quantity integer Нет Количество позиций (по умолчанию 1)
custom_id string Нет Ваш внутренний ID заказа для сверки
cURL (Лимит: 15/мин) 
curl -X POST "http://api.mayzebuy.v6.navy/api/v1/purchases"   -H "X-API-Key: Mayze_buy_YOUR_KEY"   -H "Content-Type: application/json"   -d '{"item_id": 16, "quantity": 1, "custom_id": "order_10852"}'

Пример ответа:

{
  "ok": true,
  "purchase_id": 19,
  "custom_id": "order_10852",
  "item_id": 16,
  "quantity": 1,
  "delivery": "https://gemini.google.com/promo/invite_code_example",
  "status": "completed"
}
Отправка Telegram Stars
POST /v1/services/tg-stars

Мгновенная доставка Telegram Stars на любой юзернейм.

Поле Тип Обязательное Описание
username string Да Юзернейм получателя (например: durov или @durov)
quantity integer Да Количество Stars (минимум 50)
custom_id string Нет Ваш номер заказа
cURL (Лимит: 15/мин) 
curl -X POST "http://api.mayzebuy.v6.navy/api/v1/services/tg-stars"   -H "X-API-Key: Mayze_buy_YOUR_KEY"   -H "Content-Type: application/json"   -d '{"username": "durov", "quantity": 50, "custom_id": "stars_001"}'
Подарок Telegram Premium
POST /v1/services/tg-premium

Прямая выдача подписки Telegram Premium на 3, 6 или 12 месяцев на любой аккаунт.

Поле Тип Обязательное Описание
username string Да Юзернейм получателя (например: durov)
months integer Да Срок подписки: 3, 6 или 12
cURL (Лимит: 15/мин) 
curl -X POST "http://api.mayzebuy.v6.navy/api/v1/services/tg-premium"   -H "X-API-Key: Mayze_buy_YOUR_KEY"   -H "Content-Type: application/json"   -d '{"username": "durov", "months": 3}'
Проверка заказа и повторная выдача
GET /v1/purchases/{purchase_id}

Позволяет проверить статус заказа и повторно получить выданные ключи или ссылки.

cURL 
curl "http://api.mayzebuy.v6.navy/api/v1/purchases/19"   -H "X-API-Key: Mayze_buy_YOUR_KEY"
История всех покупок
GET /v1/purchases?limit=20&offset=0

Возвращает список выполненных заказов с пагинацией.

cURL 
curl "http://api.mayzebuy.v6.navy/api/v1/purchases?limit=10"   -H "X-API-Key: Mayze_buy_YOUR_KEY"
Коды ответов и ошибок
Код Значение Описание
200 OK Успешно Запрос выполнен, данные возвращены
400 Bad Request Неверные параметры Отсутствуют обязательные поля или передан некорректный JSON
401 Unauthorized Не авторизован Отсутствует или недействителен заголовок X-API-Key
402 Payment Required Недостаточно средств Баланс меньше суммы покупки. Пополните баланс в боте
404 Not Found Не найдено Товар или заказ с данным ID не найден
409 Conflict Нет на складе Товар временно закончился на складе
429 Too Many Requests Лимит превышен Превышен лимит запросов (60/мин для чтения, 15/мин для покупок). Заголовок Retry-After указывает время ожидания
Интерактивный тестер API

Вставьте ваш API-ключ из бота, чтобы протестировать методы прямо в браузере:

// Результат выполнения появится здесь...