Ferramentas · Downloads

O módulo Downloads pelo assistente: configurar o espaço (repositório ou um arquivo só, categorias, aprovação), criar o item, enviar os arquivos por link ou arquivo, publicar, ver o que você pode baixar e os contadores da equipe.

Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.

#Em resumo

O espaço se cria com create_space e module: "downloads". Quem pode enviar é o Quem pode postar do espaço (update_space_access): por padrão, só a equipe. O preço do item se define no produto que nasce com ele (update_product, update_price, publish_product; ver Vendas e planos).

#get_downloads_space_settings

Só consulta

Configuração do espaço. O modo (multi, repositório; single, um arquivo só), se os itens dos membros esperam aprovação e as categorias (id, nome e quantos itens). Papel mínimo: qualquer que veja o espaço.

Peça assim: "Como está configurado o espaço Materiais?"

#update_downloads_space_settings

Altera

Configurar o espaço. Muda o modo, a aprovação e as categorias. Só o que você mandar muda. Papel mínimo: administrador.

Leia get_downloads_space_settings antes, para pegar os ids.

Peça assim: "No espaço Materiais, crie as categorias Planilhas e E-books e peça aprovação para o que os membros enviarem."

#list_download_items

Só consulta

Itens do espaço. Do mais novo ao mais antigo: título, categoria, arquivos e situação. A equipe e o autor veem também rascunhos e itens em análise. Um item pago que a pessoa não comprou vem travado: mostra o preço e o produto, sem arquivos. Papel mínimo: qualquer que veja o espaço.

#get_download_item

Só consulta

Um item. Descrição, categoria, arquivos (id, nome, tipo, tamanho e, para a equipe, quantos downloads), situação e o produto (preço, se é gratuito, se esgotou e o seu lugar na lista de espera). Item travado não mostra arquivos. Papel mínimo: qualquer que veja o espaço.

#create_download_item

Altera

Criar um item. Cria o item em rascunho, com o seu produto (tipo Download, gratuito, em rascunho), devolvido em product. Depois: envie os arquivos com upload_download_file, defina o preço com update_product e publique com update_download_item. Papel: quem o Quem pode postar do espaço permite; por padrão, a equipe (o membro recebe 403).

Num espaço no modo single, um segundo item é recusado (409). Itens de membros esperam aprovação quando o espaço pede.

Peça assim: "Crie no espaço Materiais o item Planilha de fluxo de caixa, na categoria Planilhas."

#update_download_item

Altera

Editar e publicar. Muda título, descrição, categoria, stamp_pdf, a capa (remove_cover a tira) e a situação (status: draft ou published; publicar exige pelo menos um arquivo). Só o que você mandar muda. Papel: o autor e a equipe.

Peça assim: "Publique o item Planilha de fluxo de caixa e ligue o carimbo nos PDFs."

#delete_download_item

Pede confirmação

Apagar o item. Apaga o item e os arquivos; o produto dele é arquivado. É recusado (409) enquanto uma compra paga ainda dá acesso: reembolse antes. Papel: o autor e a equipe.

Devolve: na primeira chamada, o resumo do que será apagado e o código de confirmação.

#upload_download_file

Altera

Enviar um arquivo. Acrescenta um arquivo ao item, por link público ou por base64. Aceita imagens (PNG, JPG, WEBP, GIF), planilhas (XLS, XLSX, ODS, CSV), PDF, documentos (DOC, DOCX, ODT, TXT, MD, PPT, PPTX) e ZIP, nunca executáveis; o nome precisa manter a extensão e o conteúdo precisa bater com o tipo (conferido pelos primeiros bytes), como no navegador. Papel: o autor e a equipe.

No modo single, o item guarda um arquivo só: para enviar de novo, passe replace_file_id. O aviso de uso do armazenamento só avisa.

Peça assim: "Envie https://exemplo.memberfy.net/fluxo.xlsx para o item Planilha de fluxo de caixa."

#remove_download_file

Pede confirmação

Remover um arquivo. O arquivo é apagado e o espaço volta. Se era o último de um item publicado, o item volta a rascunho. Papel: o autor e a equipe.

#reorder_download_files

Altera

Reordenar os arquivos. file_ids é a lista completa, do primeiro ao último. Papel: o autor e a equipe.

#get_download_url

Só consulta

O link de um arquivo. Um link que vale 5 minutos. Peça só quando a pessoa quiser mesmo o arquivo; não guarde nem repasse. A equipe e o autor sempre recebem; os outros precisam de acesso (item grátis, compra ativa ou plano que inclui o produto; ter baixado antes não basta). Papel mínimo: qualquer que veja o espaço.

Devolve: o link e stamped: true quando é a cópia com o carimbo (só para quem não é da equipe), false quando é o original. Cada download de membro entra nos contadores.

Item pago que a pessoa não tem responde 403, com o preço (a compra é feita no app); item esgotado responde 409, e o assistente sugere join_waitlist.

#list_my_downloads

Só consulta

Os seus downloads. Os itens que você pode abrir, com a origem do acesso (purchase, plan, open, team), o seu último download e, em compra, a data e o fim do acesso. Papel mínimo: qualquer.

#get_download_stats

Só consulta

Contadores do item. Quantas vezes cada arquivo foi baixado, no total e por pessoas diferentes. Só números, nunca quem. Papel mínimo: moderador (ou financeiro).

#Relacionados

• Downloads
• Ferramentas
• Dinheiro e confirmação