POST /api/v1/products · Headers: X-Api-Client-Token, Authorization: Bearer <user_token>
O produto é criado em nome do produtor, por isso a rota exige o public_token recebido em Criar usuário. Preço, métodos de pagamento e parcelamento não ficam no produto: são configurados na oferta.
1
Descubra o category_id
Consulte
GET /api/v1/products/categories com os mesmos headers. A resposta traz data, uma lista de objetos com value (ID da categoria) e label (nome). Use o value no passo seguinte.cURL
2
Crie o produto
Envie
POST /api/v1/products como application/json para produtos course ou ebook. Produtos physical exigem multipart/form-data por causa do arquivo image_stock.3
Guarde o hash
O response
201 Created devolve o produto com o campo hash. Ele é o product_hash usado na rota de oferta.Parâmetros obrigatórios (body)
string
required
Nome do produto (3 a 191 caracteres).
integer
required
ID da categoria, obtido em
GET /products/categories.string
required
Descrição do produto (3 a 1000 caracteres).
string
required
course, ebook ou physical.string
required
E-mail de suporte válido (máximo 191 caracteres).
string
required
Telefone de suporte (máximo 20 caracteres). Ex.:
11999999999.integer
required
Prazo de reembolso em dias:
7, 15 ou 30.string
required
Descritor que aparece na fatura do cartão do comprador. Apenas alfanumérico, até 13 caracteres. Ex.:
MEUPRODUTO.Parâmetros opcionais relevantes
boolean
default:"true"
Se permite afiliação. Atenção: o padrão é
true, e nesse caso affiliate_percentage (1 a 80), affiliation_description e affiliation_terms (50 a 1000 caracteres cada) passam a ser obrigatórios. Para a primeira venda, envie false.boolean
default:"false"
Se permite afiliação automática.
string
URL da imagem de capa.
file
Documento de garantia. Obrigatório apenas para
physical (PNG, JPG ou JPEG, até 10 MB, via multipart/form-data).Exemplo mínimo (produto digital)
cURL
Response de sucesso (201 Created)
string
required
Hash único do produto. É o
product_hash da rota POST /products/{product_hash}/offers.string
required
approved, pending ou reproved.mixed
required
Ecoam os valores enviados.
Com o
hash em mãos, siga para Criar oferta do produto.