Tools de Gumroad
Las 12 operaciones de Gumroad que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Listar productosGETLista los productos de la cuenta, del más nuevo al más antiguo, 10 por página, en forma resumida: Obtener producto devuelve el producto completo. Cuando hay más, la respuesta trae next_page_key, que va en page_key.
- Obtener productoGETDevuelve un producto con precio, descripción, categoría, etiquetas, variantes, archivos y, con el scope view_sales, sales_count y sales_usd_cents.
- Listar categoríasGETLista las categorías de producto de Gumroad. El path de una categoría, como design/ui-and-web/figma, va en category en Crear producto y Actualizar producto.
- Crear productoPOSTCrea un producto y lo publica de inmediato, salvo que draft sea true. Cuando la publicación está bloqueada, por ejemplo por un email sin confirmar o por falta de método de cobro, el producto queda como borrador y la respuesta trae un warning: publícalo después con Publicar producto.
- Actualizar productoPUTModifica un producto y lo devuelve. Solo cambian los campos enviados, pero tags reemplaza la lista completa. Un warning en la respuesta indica códigos de oferta que dejaron de ser válidos para el producto.
- Publicar productoPUTPublica un borrador o un producto despublicado, para que los compradores puedan comprarlo. Se rechaza mientras la cuenta no tenga email confirmado o método de cobro, o cuando un código de oferta del producto deja el precio inválido.
- Despublicar productoPUTDespublica un producto, lo que detiene nuevas ventas. Publicar producto lo vuelve a poner a la venta.
- Listar ventasGETLista las ventas exitosas de la cuenta, de las más nuevas a las más antiguas, 10 por página, con email del comprador, producto, precio, reembolso y datos de suscripción y licencia. Cuando hay más, la respuesta trae next_page_key, que va en page_key.
- Obtener ventaGETDevuelve una venta de la cuenta: comprador, producto, variantes, precio, reembolso y estado de envío, suscripción y licencia.
- Listar suscriptoresGETLista los suscriptores de un producto de membresía, con email, recurrencia, estado (alive, pending_cancellation, failed_payment, cancelled y otros) y los ids de sus ventas. Sin paginated, todos los suscriptores vienen en una respuesta.
- Listar códigos de ofertaGETLista los códigos de oferta de un producto, con amount_cents para descuento fijo o percent_off para porcentaje, uses, limit y vigencia. Un código universal vale para todos los productos.
- Crear código de ofertaPOSTCrea un código de descuento que los compradores escriben en el checkout. El descuento es en centavos de la moneda del producto, salvo que offer_type sea percent. El importe y universal no se pueden cambiar después.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
