E-commerce
Gumroad dans votre produit et vos agents IA, via une API
Le toolkit Gumroad couvre les produits et leurs catégories, la publication, les ventes, les abonnés des produits d'abonnement et les codes d'offre. Avec Connect, votre produit ou agent IA appelle le tout par un seul endpoint, pendant que Connect stocke et renouvelle les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/gumroad_create_product/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>",
"price": 1
}
}Fonctionnement
Du client connecté au premier appel à Gumroad.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Gumroad. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Gumroad.
Publier des produits depuis votre app
Un outil pour créateurs crée un produit en brouillon, le publie quand le compte peut vendre et le dépublie pour arrêter les nouvelles ventes.
Afficher ventes et abonnés
Un tableau de bord liste les ventes du compte avec acheteur, prix et remboursement, et les abonnés d'un produit d'abonnement avec leur statut.
Lancer un code de réduction
Un agent IA crée un code d'offre, en pourcentage ou en montant fixe, pour un produit ou pour tous.
Tools
12 tools Gumroad
- Lister les produitsGETListe les produits du compte, du plus récent au plus ancien, 10 par page, sous forme abrégée : Obtenir un produit renvoie le produit complet. Quand il y en a plus, la réponse contient next_page_key, à passer dans page_key.
- Obtenir un produitGETRenvoie un produit avec prix, description, catégorie, tags, variantes, fichiers et, avec le scope view_sales, sales_count et sales_usd_cents.
- Lister les catégoriesGETListe les catégories de produit de Gumroad. Le path d'une catégorie, comme design/ui-and-web/figma, va dans category de Créer un produit et Mettre à jour un produit.
- Créer un produitPOSTCrée un produit et le publie immédiatement, sauf si draft vaut true. Quand la publication est bloquée, par exemple par un e-mail non confirmé ou l'absence de moyen de versement, le produit reste en brouillon et la réponse contient un warning : publiez-le plus tard avec Publier un produit.
- Mettre à jour un produitPUTModifie un produit et le renvoie. Seuls les champs envoyés changent, mais tags remplace toute la liste. Un warning dans la réponse signale les codes d'offre devenus invalides pour le produit.
- Publier un produitPUTPublie un brouillon ou un produit dépublié, pour que les acheteurs puissent l'acheter. Refusé tant que le compte n'a pas d'e-mail confirmé ou de moyen de versement, ou quand un code d'offre du produit rend le prix invalide.
- Dépublier un produitPUTDépublie un produit, ce qui arrête les nouvelles ventes. Publier un produit le remet en vente.
- Lister les ventesGETListe les ventes réussies du compte, des plus récentes aux plus anciennes, 10 par page, avec e-mail de l'acheteur, produit, prix, remboursement et données d'abonnement et de licence. Quand il y en a plus, la réponse contient next_page_key, à passer dans page_key.
- Obtenir une venteGETRenvoie une vente du compte : acheteur, produit, variantes, prix, remboursement et statut d'expédition, abonnement et licence.
- Lister les abonnésGETListe les abonnés d'un produit d'abonnement, avec e-mail, récurrence, statut (alive, pending_cancellation, failed_payment, cancelled et autres) et les ids de leurs ventes. Sans paginated, tous les abonnés arrivent dans une seule réponse.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/gumroad, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Gumroad
Dois-je intégrer l'API Gumroad moi-même ?
Non. Connect fournit 12 tools Gumroad décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Gumroad ?
Avec le mode accepté par le toolkit : Clé d'API, OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
