Перейти к основному содержимому

REST API · MCP-сервер · TypeScript SDK

Ваш AI-ассистент теперь может вести настоящий магазин

Getly — это headless-бэкенд коммерции для цифровых товаров. Создавайте товары, принимайте оплату, доставляйте файлы, выпускайте лицензионные ключи и получайте выплаты — через REST API, MCP-сервер для Claude и Cursor и типизированный SDK. Не нужно строить витрину и нянчить платёжный стек.

Ключи выглядят как getly_sk_live_… и хранятся в переменной окружения GETLY_API_KEY.

От черновика до живого товара за пять шагов

Ниже — обычный curl, SDK не обязателен. Скопируйте, вставьте, продавайте.

  1. Создайте черновик товара

    Цены — целые числа в центах (priceCents). Товар создаётся черновиком — публично пока ничего не видно.

    bash
    curl -X POST https://www.getly.store/api/v1/products \
      -H "Authorization: Bearer $GETLY_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Notion Icon Pack",
        "priceCents": 900,
        "description": "500 hand-drawn icons for Notion dashboards."
      }'
    Ответ · 201 · application/json
    {
      "success": true,
      "data": {
        "id": "6b4e6a52-9d2e-4c8a-b1f3-2a9c0d5e7f10",
        "name": "Notion Icon Pack",
        "slug": "notion-icon-pack-m9x2kz",
        "status": "draft",
        "priceCents": 900,
        "urls": {
          "product": "https://www.getly.store/product/notion-icon-pack-m9x2kz",
          "buy": "https://www.getly.store/product/notion-icon-pack-m9x2kz"
        }
      }
    }
  2. Получите URL для загрузки

    API возвращает подписанный URL для файлов до 2 ГБ. Байты идут напрямую в хранилище, минуя наши серверы.

    bash
    curl -X POST https://www.getly.store/api/v1/products/$PRODUCT_ID/files/presign \
      -H "Authorization: Bearer $GETLY_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "fileName": "icons.zip", "fileSize": 1048576, "fileType": "application/zip" }'
    Ответ · 200 · application/json
    {
      "success": true,
      "data": {
        "uploadUrl": "https://<account>.r2.cloudflarestorage.com/...&X-Amz-Signature=...",
        "fileUrl": "https://pub-xxxxxxxx.r2.dev/files/.../aB3xYz.zip",
        "fileName": "icons.zip",
        "fileSize": 1048576
      }
    }
  3. Загрузите файл и прикрепите его

    Отправьте байты PUT-запросом на upload URL, затем прикрепите полученный fileUrl к товару.

    bash
    curl -X PUT "$UPLOAD_URL" \
      -H "Content-Type: application/zip" \
      --data-binary @icons.zip
    
    curl -X POST https://www.getly.store/api/v1/products/$PRODUCT_ID/files \
      -H "Authorization: Bearer $GETLY_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "fileUrl": "<fileUrl from step 2>", "fileName": "icons.zip",
            "fileSize": 1048576, "fileType": "application/zip" }'
    Ответ · 201 · application/json
    {
      "success": true,
      "data": {
        "id": "0f8c31d7-4e2a-49b6-9c1d-8e5a7b3f2c40",
        "fileName": "icons.zip",
        "fileSize": 1048576,
        "isLatest": true
      }
    }
  4. Опубликуйте

    Один вызов — и товар в продаже. Если чего-то не хватает, вы получите машиночитаемые причины, а не расплывчатую ошибку.

    bash
    curl -X POST https://www.getly.store/api/v1/products/$PRODUCT_ID/publish \
      -H "Authorization: Bearer $GETLY_API_KEY"
    Ответ · 200 · application/json
    {
      "success": true,
      "data": {
        "id": "6b4e6a52-9d2e-4c8a-b1f3-2a9c0d5e7f10",
        "status": "active",
        "priceCents": 900,
        "urls": {
          "product": "https://www.getly.store/product/notion-icon-pack-m9x2kz",
          "buy": "https://www.getly.store/product/notion-icon-pack-m9x2kz"
        }
      }
    }
  5. Товар в продаже

    Покупатели платят картой или криптовалютой — гостевой чекаут, аккаунт не нужен. Файлы доставляются автоматически.

    bash
    open https://www.getly.store/product/notion-icon-pack-m9x2kz

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

Подключите к своему AI-ассистенту

Официальный MCP-сервер (@getly/mcp) даёт Claude, Cursor и любому MCP-клиенту 16 инструментов: создавать и публиковать товары, загружать файлы, писать посты, выпускать купоны и ссылки на оплату, смотреть продажи. Один блок конфигурации — и ваш ассистент ведёт магазин.

Claude Code

bash
claude mcp add getly --env GETLY_API_KEY=$GETLY_API_KEY -- npx -y @getly/mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "getly": {
      "command": "npx",
      "args": ["-y", "@getly/mcp"],
      "env": { "GETLY_API_KEY": "getly_sk_live_..." }
    }
  }
}

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "getly": {
      "command": "npx",
      "args": ["-y", "@getly/mcp"],
      "env": { "GETLY_API_KEY": "getly_sk_live_..." }
    }
  }
}

Сервер читает ключ только из переменной окружения GETLY_API_KEY. Никогда не вставляйте ключи в промпты, код или коммиты.

Одна честная комиссия. Всё включено.

Getly берёт 20% с каждой продажи — и это весь счёт. Прежде чем назвать это дорогим, посмотрите, что эти 20% реально покрывают.

Что вы получаетеGetly — 20% за всёТипичные платёжные API-провайдеры
Приём платежей (карты + криптовалюта)Включено4–10% + фиксированная комиссия за транзакцию
Хостинг и доставка файлов до 2 ГБВключеноФайлы храните и раздаёте сами
Трафик маркетплейса и SEOВключено — ваши товары в каталоге GetlyВесь трафик приводите вы
Встроенная партнёрская сетьВключеноСтройте и оплачивайте свою
Криптовыплаты (USDT/USDC)Включено — 5 сетей, банковский счёт не нуженПочти никогда не предлагается
Выпуск и проверка лицензионных ключейВключеноОтдельный платный сервис
Фиксированная месячная плата$0 — платите только когда продаёте$0–99+, плюс собственная инфраструктура

Новые продавцы первые 3 месяца оставляют себе 90%.

Сделано под то, как софт продаётся в 2026-м

Криптовыплаты

Получайте выплаты в USDT или USDC в 5 сетях (Ethereum, Tron, BSC, Polygon, Solana). Банковский счёт не нужен — достаточно адреса кошелька.

Гостевой чекаут

Покупателям не нужен аккаунт Getly. Карта или криптовалюта: оплатил, скачал — готово. Меньше шагов — выше конверсия.

MCP прежде всего

Не прикрученный сбоку чат-бот, а настоящий MCP-сервер с типизированными инструментами и предохранителями: Claude или Cursor могут управлять всем каталогом.

API лицензионных ключей

Выпускайте ключи при покупке, проверяйте и активируйте их из своего приложения — публичному validate-эндпоинту секрет вообще не нужен.

Три ручных шага

Не будем притворяться, что их ноль. Вне API происходят ровно три вещи — все одноразовые:

  1. Зарегистрируйтесь

    Google, GitHub или магическая ссылка. Тридцать секунд.

  2. Создайте API-ключ

    Один клик в личном кабинете — заодно создаётся магазин. Выбирайте только нужные права (scopes).

  3. Подключите способ выплат

    Одна ссылка на онбординг Stripe — или вставьте адрес кошелька USDT/USDC.

Всё остальное — товары, файлы, посты, купоны, ссылки на оплату, лицензионные ключи, вебхуки, история выплат — делается через API.

Весь магазин — в виде эндпоинтов

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

write:products

Товары

Создавайте, обновляйте, публикуйте и архивируйте товары; загружайте файлы до 2 ГБ по подписанным URL.

write:posts

Посты в блог

Markdown-блог магазина со вставками товаров — контент-маркетинг из cron-задачи.

write:coupons

Купоны

Процентные и фиксированные скидки с лимитами и сроком действия — с защитой от случайной скидки в 100%.

checkout:create

Ссылки на оплату

Создайте URL с уже применённым купоном, своим reference и metadata — опрашивайте статус или ловите вебхук о покупке.

read:licenses

Лицензионные ключи

Выпускаются автоматически при покупке; проверяйте и активируйте из своего софта через публичный эндпоинт без секретов.

webhooks:manage

Вебхуки

Подписанные события (sale.completed, license.activated и другие) со схемой HMAC-подписи с меткой времени.

read:store

Выплаты

Смотрите баланс и историю выплат по обоим каналам — Stripe и стейблкоины.

Спецификации и справочники

Запустите магазин уже сегодня

API-ключ — в одном клике, а первые три месяца вы оставляете себе 90%.

Получить API-ключ