Produtos

Listar produtos e ofertas

GET /product/list/product/checkout/{projectId}

Devolve {"products": [...]}. Cada produto traz os seus dados e a lista offer, com as ofertas dele. Use essa rota para descobrir os IDs dos produtos e das ofertas que já existem.

curl

curl https://bff.assiny.com.br/v1/public/product/list/product/checkout/SEU_PROJECT_ID \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "ProjectId: SEU_PROJECT_ID"

Criar produto

POST /product

Campo	Tipo	Descrição
`projectId`	UUID	Obrigatório. Projeto onde o produto será criado.
`name`	texto	Obrigatório. Nome interno do produto.
`nameDisplayed`	texto	Obrigatório. Nome mostrado ao comprador no checkout.
`class`	texto	Obrigatório. `DIGITAL` ou `PHYSICAL`.
`productCategoryId`	UUID	Obrigatório. Categoria do produto. Use um ID da tabela abaixo.
`supportEmail`	texto	Obrigatório. E-mail de suporte mostrado ao comprador.
`productorName`	texto	Obrigatório. Nome do produtor.
`description`	texto	Descrição do produto.
`productType`	texto	`PRODUCT` (padrão), `SERVICE` ou `SPLIT`.
`guarantee`	número	Garantia em dias: `7`, `15`, `30`, `60` ou `90`.
`productImage`	texto	URL da imagem do produto.
`phoneNumber`	texto	Telefone de suporte.
`language`, `currency`	texto	Idioma e moeda do checkout. Use os mesmos valores de um produto que já existe no projeto.
`isTermsEnabled`, `termsOfUse`	sim/não, texto	Exige que o comprador aceite os termos de uso informados.
`width`, `height`, `length`, `weight`	número	Medidas e peso, só para produto físico.

curl

curl -X POST https://bff.assiny.com.br/v1/public/product \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "ProjectId: SEU_PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "SEU_PROJECT_ID",
    "name": "Curso de Fotografia",
    "nameDisplayed": "Curso de Fotografia Completo",
    "class": "DIGITAL",
    "productCategoryId": "9e36e78f-f0e3-42e4-8551-e18e8cecc5cf",
    "supportEmail": "suporte@suaempresa.com.br",
    "productorName": "Sua Empresa",
    "productType": "PRODUCT",
    "guarantee": 7
  }'

A resposta (201) traz o produto criado, com o id que você vai usar para criar as ofertas.

Criar vários produtos

POST /multiple-products

Mesmo corpo do Criar produto, dentro de uma lista: [{...}, {...}]. Cada item leva o próprio projectId.

Editar produto

POST /product/{productId}

Mesmos campos do Criar produto, sem projectId — o projeto vai no cabeçalho.

Mande o produto completo, não só os campos alterados: comece pelos dados que a listagem devolve e troque o que precisar.

Categorias

Valores aceitos em productCategoryId:

Categoria	ID
Desenvolvimento Pessoal	`9e36e78f-f0e3-42e4-8551-e18e8cecc5cf`
Saúde e Bem-estar	`67374e68-ca1a-40fa-85d4-590a7ba16d66`
Renda Extra	`3611beb8-5c41-4b24-b857-97463d4bcc39`
Artes e Ofícios	`780590e5-9341-461c-9c00-66325ae7c70e`
Ensino de idiomas	`0b4ab084-3990-4c3f-b1ec-76122cf3c5ca`
Viagens e Lazer	`581dd56a-43c9-4a91-aff3-cd9c4430ed89`
Culinária e Gastronomia	`8f5a247e-2589-4388-ac5f-44e372eb5652`
Relacionamentos	`3d484fcf-0f4e-430c-b7e5-8b4668b59d35`
Finanças	`a283c3fc-8a5b-4cff-9c21-f230c314a5d3`
Midias Sociais	`08ecf47c-5468-499e-b2d7-cba13b1ba6ba`
E-commerce	`ede244ef-e49b-46cc-939a-3ae5a9262c4f`
Branding e Identidade	`a8c6674b-1fbf-4e4a-84d3-7f4d59b564ed`
Design de produto	`9c844d4c-6fe6-4fb9-8c50-d6fca043bdc3`
Marketing Digital	`4687b15f-c4c6-4d96-8346-1c7e2e88ff5b`
Automação e Ferramentas	`2edfa341-407d-402b-b446-0a97811ec1b5`
Aquisição e Ads	`6412fe3c-0901-4d4e-8de4-a0317620bc96`
Chatbots e IA	`8cd1e715-8fa2-44ba-8cb8-a9670d8384b7`
Web design e Desenvolvimento	`b7ca36bf-3fd1-4375-9112-f281c7b28d65`
Gestão de projetos	`ee9cb75a-210b-4cfa-9105-698b544e17c2`
Desenvolvimento de jogos	`a66021a5-9d8c-43e1-9aec-5b41d6c18324`

API pública

Webhooks

Estrutura dos dados

Payloads por evento

Listar produtos e ofertas

Criar produto

Criar vários produtos

Editar produto

Categorias