Ваш ШІ-асистент тепер може вести справжній магазин

Від чернетки до живого товару за п'ять кроків

Усе нижче - звичайний curl, SDK не потрібен. Копіюйте, вставляйте, продавайте.

1. 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. 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. 3

   Завантажте файл і прикріпіть його

   Надішліть PUT із сирими байтами на 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. 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. 5

   Схвалено і в продажу

   Покупці платять USDT/USDC, оформлення як гість, акаунт не потрібен. Файли доставляються автоматично.

   bash

   Копіювати

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

Чесна примітка: кожен новий товар проходить перевірку (статус pending_review), перш ніж з'явитися публічно, зазвичай протягом кількох годин. Це стосується й товарів, створених через API, незалежно від вашої історії продажів.

Підключіть його до вашого ШІ-асистента

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

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

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

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

Сервер читає ваш ключ лише зі змінної середовища GETLY_API_KEY. Ніколи не вставляйте ключі в промпти, код чи коміти.

Одна чесна комісія. Усе включено.

Продажі, які ви приводите через API чи віджет, - це ваш власний трафік: Getly бере 10%, і це весь рахунок. Продажі з маркетплейсу починаються з 20% і знижуються до 12% зі зростанням обсягу. Повна модель - на getly.store/pricing, а нижче видно, що саме покриває ця єдина комісія.

Нові продавці залишають собі 90% протягом перших 90 днів.

Створено для того, як продається софт у 2026 році

Увесь магазин у вигляді ендпоінтів

Усі можливості нижче мають пагінацію за курсором, ключі ідемпотентності, заголовки лімітів запитів і помилки, зрозумілі для LLM.

Кейс

BotLaunch керує своїм маркетплейсом шаблонів через цей API

BotLaunch, no-code платформа для Telegram-ботів і магазинів Mini App, підключає акаунти своїх авторів до Getly і публікує їхні шаблони як живі товари Getly, повністю через той самий API, який щойно показала ця сторінка.

Специфікації та посилання