MagStore API

REST-подобный интерфейс поверх одного эндпойнта /resale/api. Работает через GET (query-строка) и POST (JSON) — как в стандарте API.md. Все ответы — JSON с единой оболочкой { success, message, data, timestamp, datetime }, либо text/plain для скачивания карточек товара.

Авторизация

Все запросы к API требуют пары email + token. Токен выдаётся администратором вручную и уникален для каждого клиента. Компрометацию токена сообщите администратору — он выпустит новый и мгновенно отзовёт старый.

Способы передачи:

• GET-параметры: ?email=...&token=...
• JSON-поля тела POST-запроса: {"email":"...","token":"..."}
• Заголовок: Authorization: Bearer <token>

Формат ответа

Любой JSON-ответ обёрнут одинаково — можно распарсить одним типом:

// success
{
  "success": true,
  "message": "ok",
  "data": { /* payload */ },
  "timestamp": 1753900000,
  "datetime": "2026-07-30T18:26:40.000Z"
}

// error (HTTP 4xx/5xx)
{
  "success": false,
  "message": "insufficient_funds",
  "data": null,
  "timestamp": 1753900000,
  "datetime": "2026-07-30T18:26:40.000Z"
}

Все суммы — целое число «центов»: 1 USD = 10 000 единиц (total_cents / 10000 === USD).

Возвращает текущий баланс и персональную скидку.

GET /resale/api?action=balance&email={email}&token={token}

{
  "success": true,
  "data": {
    "user_id": 42,
    "login": "acme",
    "balance_cents": 12500000,   // $1250.00
    "discount_percent": 10
  }
}

Только товары, включённые администратором в канал MagStore. Цены уже уменьшены на вашу персональную скидку.

GET /resale/api?action=list&email={email}&token={token}

{
  "success": true,
  "data": [
    {
      "id": 1,
      "code": "INST_2FA",
      "name": "Long-Live Instagram Gmail",
      "description": "...",
      "discount_percent": 0,
      "price_cents": 7000,        // cheapest enabled tier (with discount)
      "list_price_cents": 7000,   // cheapest tier, undiscounted
      "available": 16903,      // total across enabled tiers
      "tiers": [
        {
          "key": "t0_3",           // pass this as tier_key on purchase
          "label": "0–3 дня",
          "price_cents": 7000,      // $0.70 per unit (with discount)
          "list_price_cents": 7000,
          "available": 9021
        },
        {
          "key": "t21",
          "label": "21 день+",
          "price_cents": 14500,
          "list_price_cents": 14500,
          "available": 7882
        }
      ]
    }
  ]
}

Каждый товар делится на возрастные интервалы (tiers) со своей ценой: t0_3 (0–3 дня), t4_14 (4–14 дней), t15_20 (15–20 дней), t21 (21 день+). В ответе только включённые интервалы; поле key нужно передавать как tier_key при покупке.

Возвращает объект того же формата, что и элемент list.

# канонический вид
GET /resale/api?action=product&goods_id={id}&email=…&token=…

# API.md-совместимый вид
GET /resale/api?action={id}&email=…&token=…

Двухшаговый flow: шаг 1 — размещение заказа (списывает баланс атомарно), возвращает invoice_id. Шаг 2 — забор содержимого по этому invoice_id (см. следующий раздел).

POST /resale/api
Content-Type: application/json

{
  "email": "you@example.com",
  "token": "…",
  "action": "purchase_v2",
  "goods_id": 1,
  "tier_key": "t0_3",
  "quantity": 10
}

{
  "success": true,
  "data": {
    "invoice_id": "29BF50fC037d14d",
    "goods_id": 1,
    "tier_key": "t0_3",
    "quantity": 10,
    "unit_price_cents": 7000,
    "total_cents": 70000,
    "list_price_cents": 7000,
    "discount_percent": 0
  }
}

curl -s https://shooac.top/resale/api \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","token":"…","action":"purchase_v2","goods_id":1,"tier_key":"t0_3","quantity":10}'

Забирает карточки по invoice_id. Можно вызвать несколько раз — контент неизменен. Через 24 часа после доставки контент удаляется — придёт 410 Gone / content_expired.

GET /resale/api?action=query_card&invoice_id={id}&email=…&token=…

{
  "success": true,
  "data": {
    "invoice_id": "29BF50fC037d14d",
    "goods_id": 1,
    "quantity": 10,
    "status": "delivered",
    "card_content": "login:pass:cookie\nlogin:pass:cookie\n…",
    "expired": false
  }
}

GET /resale/api?action=query_card&invoice_id={id}&format=txt&email=…&token=…

Ошибки

Лимиты

• Rate-limit API: до 120 запросов в минуту с одного IP.
• Максимальное количество в одной покупке: 5000 единиц.
• Тело POST-запроса: не более 64 КБ.
• Токен — один активный на пользователя; ротация мгновенная.

Вопросы, ошибки, ротация токена — пишите администратору.