Produtos

Leia, crie, atualize e exclua produtos do catálogo no contexto selecionado.

Operações

Listar — ProdutosConsulte os dados de “Produtos”. O resultado depende dos parâmetros desta operação. GET Obter — ProdutosVeja listas de produtos e detalhes do produto. GET Criar — ProdutosAdicione novos produtos ao catálogo. POST Atualizar — ProdutosAltere produtos, preços e dados de publicação existentes. PATCH Excluir — ProdutosRemover produtos do painel administrativo, da loja e da busca, preservando o histórico das transações. DELETE Produtos · Adicionar arquivos · upload_idEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. POST Produtos · Estado · upload_idEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. GET Produtos · Adicionar arquivos · multipartEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. PUT Produtos · Arquivos do produtoEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. GET Produtos · Adicionar arquivos · product_idEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. POST Produtos · Baixar · ArquivoEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. GET Produtos · CabeçalhosEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. HEAD Produtos · Adicionar arquivos · VersãoEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. POST Produtos · Remover · ArquivoEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. DELETE Produtos · Versões digitaisEnvie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers. GET Produtos · Adicionar arquivos · RascunhoEsta operação foi descontinuada e retorna 409 sem alterar dados. Configure o acesso de cada arquivo digital pela seleção de destinatários. POST Produtos · Requisição · RascunhoEsta operação foi descontinuada e retorna 409 sem alterar dados. Configure o acesso de cada arquivo digital pela seleção de destinatários. PATCH Produtos · Remover · RascunhoEsta operação foi descontinuada e retorna 409 sem alterar dados. Configure o acesso de cada arquivo digital pela seleção de destinatários. DELETE Produtos · Publicar versãoEsta operação foi descontinuada e retorna 409 sem alterar dados. Configure o acesso de cada arquivo digital pela seleção de destinatários. POST Produtos · Retirar ofertaEsta operação foi descontinuada e retorna 409 sem alterar dados. Configure o acesso de cada arquivo digital pela seleção de destinatários. POST Produtos · Acesso a arquivos futuros após a compraEsta operação foi descontinuada e retorna 409 sem alterar dados. Configure o acesso de cada arquivo digital pela seleção de destinatários. PATCH Consultar destinatários de um arquivoLeia a regra de acesso e a versão do produto. A primeira publicação continua sendo a data de referência. GET Escolher destinatários de um arquivoEscolha as compras autorizadas. Os pedidos selecionados devem conter este produto pago e não reembolsado. PATCH

Como funciona

A integração pode ler produtos não excluídos, incluindo rascunhos, exceto os bloqueados por um limite do plano. Produtos bloqueados são omitidos das listas; o acesso direto retorna entitlements.resource_blocked. Assim, a visibilidade na API difere da publicação na loja.

Use identificadores existentes de marcas, categorias, características e arquivos de mídia. Os preços incluem moeda, lista de preços, tratamento fiscal e versões explícitas de concorrência. Preços de produtos e variantes são distintos; use a estrutura de preços aceita e textos decimais exatos.

Arquivos do produto

Envie os arquivos como multipart/form-data após criar upload_id e associe-os ao produto. O download exige um token Bearer e permissão para category; a resposta contém os bytes, sem endereço público nem senha. Regra explícita de acesso ao arquivo compartilhado. new_purchases / recent_and_new / selected / all_purchasers.

Escolha um arquivo PDF, ZIP, EPUB, MP3 ou MP4, WebP, PNG, JPG, SVG, AVIF válido. Até 250 MiB por arquivo. Um produto pode ter até 20 arquivos ativos.