Ao enviar pedidos para o GelatoConnect pela API ou outros métodos de Order intake, é preciso fornecer URLs de download direto para seus Arquivos para impressão. As URLs devem permitir que o GelatoConnect baixe seus arquivos sem exigir autenticação ou interação do usuário. Este guia mostra como criar links de download direto para arquivos armazenados nos serviços de armazenamento em nuvem mais populares.
Dropbox
Os links de compartilhamento do Dropbox geralmente terminam com ?dl=0, o que abre uma página de visualização em vez de baixar o arquivo diretamente. Para criar um link de download direto:
Obtenha o link de compartilhamento do seu arquivo no Dropbox
Altere o final da URL de
?dl=0para?dl=1
Exemplo:
Link original:
https://www.dropbox.com/s/abcdefg123456/filename.pdf?dl=0Link direto para download:
https://www.dropbox.com/s/abcdefg123456/filename.pdf?dl=1
Essa modificação instrui o Dropbox a iniciar o download imediatamente, em vez de exibir uma página de pré-visualização.
Google Drive
O Google Drive exige um método diferente para criar links de download direto:
Obtenha o link de compartilhamento do seu arquivo no Google Drive (clique com o botão direito → Compartilhar → Copiar link)
Extraia o ID do arquivo da URL (a longa sequência entre
/d/e/view)Crie uma nova URL usando o seguinte formato:
https://drive.google.com/uc?export=download&id=FILE_ID
Exemplo:
Link original:
https://drive.google.com/file/d/1a2b3c4d5e6f7g8h9i0j/view?usp=sharingLink direto para download:
https://drive.google.com/uc?export=download&id=1a2b3c4d5e6f7g8h9i0j
Atenção: Para arquivos grandes (acima de 100MB), o Google Drive pode exibir um aviso de verificação de vírus. O usuário pode precisar confirmar um aviso extra para concluir o download.
OneDrive
Os links do OneDrive podem ser ajustados para permitir downloads diretos:
Obtenha o link de compartilhamento do seu arquivo no OneDrive
Altere a URL adicionando o parâmetro
?download=1:
Para contas pessoais do OneDrive:
Link original:
https://onedrive.live.com/?authkey=...&cid=...&id=...Link direto para download: Altere
?para?download=1&na URL
Para contas empresariais ou do Microsoft 365 OneDrive:
Link original:
https://company-name-my.sharepoint.com/:f:/g/personal/...Link direto para download: Adicione
?download=1ao final da URL
Boas práticas para URLs de envio de pedidos
Ao criar links diretos para download de arquivos para impressão em seus pedidos do GelatoConnect:
Garanta que os arquivos estejam acessíveis corretamente - As URLs devem ser acessíveis publicamente, sem necessidade de login ou autenticação
Verifique a validade do link - Algumas opções de compartilhamento geram links temporários; certifique-se de que eles não vão expirar durante o processamento do pedido (o ideal é que sejam válidos por pelo menos 7 dias)
Teste seus links - Antes de enviar sua solicitação de pedido via API, verifique se o link de download direto está funcionando testando-o em uma janela anônima ou privada do navegador
Verifique a compatibilidade do formato do arquivo - Certifique-se de que seus arquivos atendem aos requisitos de formato do GelatoConnect (normalmente PDF para Arquivo para impressão)
URL no formato correto - Certifique-se de que a URL está incluída corretamente no campo "url" dentro do array "files" em sua solicitação de API
Armazenamento permanente - Para produtos pedidos com frequência, vale a pena considerar uma solução de armazenamento mais permanente
Soluções para pedidos com falha devido ao acesso ao arquivo
Se os seus pedidos estiverem apresentando erros de acesso a arquivos:
Verifique o status do pedido - Pedidos com arquivos inacessíveis geralmente não passam na validação e apresentam uma mensagem de erro específica
Verifique as permissões de compartilhamento - Certifique-se de que o arquivo está configurado como "Qualquer pessoa com o link pode visualizar" sem exigir login
Verifique a formatação da URL - Certifique-se de que você modificou a URL corretamente, seguindo as instruções acima
Teste no modo de navegação anônima - Abra o link em uma janela anônima ou privada do navegador para conferir se ele funciona mesmo sem estar logado
Verifique a URL na solicitação - Confirme se a URL está exatamente correta e formatada corretamente em sua solicitação de API
Limitações de tamanho de arquivo - Certifique-se de que seu arquivo não seja grande demais para o serviço em nuvem permitir o download direto