E-commerce
Gumroad no seu produto e nos seus agentes de IA, por uma API
O toolkit do Gumroad cobre produtos e categorias, publicação, vendas, assinantes de produtos de assinatura e códigos de oferta. Pelo Connect, seu produto ou agente de IA chama tudo por um só endpoint, enquanto o Connect guarda e renova as credenciais e registra cada execução.
15 dias para testar. Sem cartão de crédito.
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
}
}Como funciona
Do cliente conectado à primeira chamada no Gumroad.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Gumroad. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Gumroad.
Publique produtos pelo seu app
Uma ferramenta para criadores cria um produto como rascunho, publica quando a conta pode vender e o despublica para parar novas vendas.
Mostre vendas e assinantes
Um painel lista as vendas da conta com dados de comprador, preço e reembolso, e os assinantes de um produto de assinatura com seu status.
Lance um código de desconto
Um agente de IA cria um código de oferta, em percentual ou valor fixo, para um produto ou para todos.
Tools
12 tools do Gumroad
- Listar produtosGETLista os produtos da conta, do mais novo ao mais antigo, 10 por página, em formato resumido: Obter produto retorna o produto completo. Quando há mais, a resposta traz next_page_key, que vai em page_key.
- Obter produtoGETRetorna um produto com preço, descrição, categoria, tags, variantes, arquivos e, com o escopo view_sales, sales_count e sales_usd_cents.
- Listar categoriasGETLista as categorias de produto do Gumroad. O path de uma categoria, como design/ui-and-web/figma, vai em category em Criar produto e Atualizar produto.
- Criar produtoPOSTCria um produto e o publica na hora, a menos que draft seja true. Quando a publicação é bloqueada, por exemplo por e-mail não confirmado ou falta de forma de recebimento, o produto fica como rascunho e a resposta traz um warning: publique depois com Publicar produto.
- Atualizar produtoPUTAltera um produto e o retorna. Só os campos enviados mudam, mas tags substitui a lista inteira. Um warning na resposta indica códigos de oferta que deixaram de ser válidos para o produto.
- Publicar produtoPUTPublica um rascunho ou produto despublicado, para que compradores possam comprá-lo. Recusado enquanto a conta não tiver e-mail confirmado ou forma de recebimento, ou quando um código de oferta do produto deixa o preço inválido.
- Despublicar produtoPUTDespublica um produto, o que interrompe novas vendas. Publicar produto o coloca de volta à venda.
- Listar vendasGETLista as vendas concluídas da conta, das mais novas às mais antigas, 10 por página, com e-mail do comprador, produto, preço, reembolso e dados de assinatura e licença. Quando há mais, a resposta traz next_page_key, que vai em page_key.
- Obter vendaGETRetorna uma venda da conta: comprador, produto, variantes, preço, reembolso e status de envio, assinatura e licença.
- Listar assinantesGETLista os assinantes de um produto de assinatura, com e-mail, recorrência, status (alive, pending_cancellation, failed_payment, cancelled e outros) e os ids de suas vendas. Sem paginated, todos os assinantes vêm em uma resposta.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/gumroad, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
Perguntas sobre o toolkit do Gumroad
Preciso implementar a API do Gumroad?
Não. O Connect já traz 12 tools do Gumroad descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Gumroad?
Pelo modo que o toolkit aceita: Chave de API, OAuth com o app do seu produto. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
