Votre assistant IA peut maintenant gérer une vraie boutique

Du brouillon au produit en ligne en cinq étapes

Tout ce qui suit est du simple curl : aucun SDK requis. Copiez, collez, vendez.

1. 1

   Créer un produit brouillon

   Les prix sont des entiers en centimes (priceCents). Le produit démarre en brouillon : rien n'est encore public.

   bash

   Copier

   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."
     }'

   Réponse · 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

   Obtenir une URL de téléversement

   L'API renvoie une URL présignée pour des fichiers jusqu'à 2 Go. Vos octets vont directement au stockage, sans passer par nos serveurs.

   bash

   Copier

   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" }'

   Réponse · 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

   Téléversez le fichier et rattachez-le

   Envoyez les octets bruts en PUT vers l'URL de téléversement, puis rattachez au produit le fileUrl renvoyé.

   bash

   Copier

   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" }'

   Réponse · 201 · application/json

   {
     "success": true,
     "data": {
       "id": "0f8c31d7-4e2a-49b6-9c1d-8e5a7b3f2c40",
       "fileName": "icons.zip",
       "fileSize": 1048576,
       "isLatest": true
     }
   }

4. 4

   Publier

   Un seul appel soumet le produit à vérification ; il est mis en ligne une fois approuvé, généralement en quelques heures. S'il manque quelque chose, vous recevez des motifs lisibles par machine au lieu d'une erreur vague.

   bash

   Copier

   curl -X POST https://www.getly.store/api/v1/products/$PRODUCT_ID/publish \
     -H "Authorization: Bearer $GETLY_API_KEY"

   Réponse · 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

   Approuvé et en vente

   Les acheteurs paient en USDT/USDC, en invité, sans compte nécessaire. Les fichiers sont livrés automatiquement.

   bash

   Copier

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

Note d'honnêteté : chaque nouveau produit passe par une vérification (statut pending_review) avant d'apparaître publiquement, généralement en quelques heures. Cela vaut aussi pour les produits créés via l'API, quel que soit votre historique de ventes.

Branchez-le à votre assistant IA

Le serveur MCP officiel (@getly/mcp) donne à Claude, Cursor et à tout client MCP 16 outils : créer et publier des produits, téléverser des fichiers, rédiger des articles, générer des coupons et des liens de paiement, consulter les ventes. Un bloc de configuration, et votre assistant devient commerçant.

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_..." }
    }
  }
}

Le serveur lit votre clé uniquement depuis la variable d'environnement GETLY_API_KEY. Ne collez jamais de clés dans des prompts, du code ou des commits.

Une seule commission honnête. Tout compris.

Les ventes que vous générez via l'API ou le widget sont votre propre trafic : Getly prélève 10 %, et c'est toute la facture. Les ventes issues de la place de marché commencent à 20 % et descendent à 12 % avec le volume. Le modèle complet est sur getly.store/pricing, et regardez ce que cette unique commission couvre réellement.

Les nouveaux vendeurs gardent 90 % pendant leurs 90 premiers jours.

Conçu pour la façon dont le logiciel se vend en 2026

Toute la boutique, en endpoints

Toutes les fonctionnalités ci-dessous incluent pagination par curseur, clés d'idempotence, en-têtes de limite de débit et erreurs lisibles par les LLM.

Étude de cas

BotLaunch gère sa place de marché de modèles avec cette API

BotLaunch, une plateforme sans code pour les bots Telegram et les boutiques Mini App, relie les comptes de ses auteurs à Getly et publie leurs modèles comme produits Getly en ligne, entièrement via la même API que celle présentée sur cette page.

Spécifications et références