Tools Gumroad
Les 12 opérations Gumroad que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- 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.
- Lister les codes d'offreGETListe les codes d'offre d'un produit, avec amount_cents pour une remise fixe ou percent_off pour un pourcentage, uses, limit et validité. Un code universel s'applique à tous les produits.
- Créer un code d'offrePOSTCrée un code de réduction que les acheteurs saisissent au paiement. La réduction est en centimes de la devise du produit, sauf si offer_type vaut percent. Le montant et universal ne peuvent plus être modifiés ensuite.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
