Pandafile · 50 GB grátis todas as semanas
API de transferência de arquivos para seus apps e fluxos de trabalho
A Pandafile tem uma API REST para enviar arquivos grandes a partir do seu próprio código, dos seus servidores e das suas ferramentas no-code. Crie uma transferência, envie os arquivos com uploads retomáveis, mande links pessoais por e-mail aos destinatários e receba um webhook quando alguém baixar. A API faz parte do Pro e do Team, segue os mesmos limites do app web e é descrita em um documento OpenAPI 3.1 público. Com as chaves de teste, você desenvolve e roda testes sem enviar e-mails de verdade nem usar o seu armazenamento.
Uma API REST descrita em OpenAPI 3.1
Todos os endpoints ficam em /api/v1 e falam JSON. Você se autentica com uma chave de API no cabeçalho Authorization, como token Bearer. As chaves são criadas no seu painel, aparecem uma única vez e podem ser limitadas a somente leitura, leitura e escrita, ou acesso total, para que um script de relatórios nunca tenha poder de excluir transferências. Toda a API é descrita em um documento OpenAPI 3.1 legível por máquina em /api/v1/openapi.json, que você pode carregar no Postman, usar para gerar um cliente ou passar para um assistente de programação com IA. O guia para desenvolvedores em /developers explica os conceitos, e a referência da API em /developers/api lista cada endpoint com exemplos. Toda resposta traz um ID de requisição, os limites de uso aparecem nos cabeçalhos RateLimit, as listas usam paginação por cursor e os erros seguem um único formato JSON.
Uploads retomáveis com tus
Arquivos grandes e redes instáveis não combinam com uma única requisição HTTP longa. Para enviar arquivos, primeiro você cria uma transferência com POST /api/v1/transfers, informando os arquivos, o título, a mensagem e, se quiser, os e-mails dos destinatários. Depois, cada arquivo é enviado com tus, o protocolo aberto para uploads retomáveis, então uma conexão que cai ou um servidor reiniciado continua a partir do último byte em vez de começar de novo. Há clientes tus prontos para JavaScript, Python, Go, Java, .NET, Swift e outras linguagens. Quando todos os arquivos chegarem, você chama complete e a transferência vira um link normal da Pandafile, com página de download, links pessoais para os destinatários, lembretes e prazo de expiração. Valem os mesmos limites do plano que no navegador: até 1000 GB por transferência e 1500 GB de armazenamento no Pro.
Envie arquivos direto de uma URL
Às vezes o arquivo já está em outro lugar: um anexo do CRM, a saída de uma render farm ou uma exportação em outro servidor. POST /api/v1/transfers/from-url aceita URLs HTTPS e deixa a Pandafile buscar os arquivos por você, depois cria e conclui a transferência. A requisição espera até 20 segundos. Importações pequenas voltam já concluídas, e as maiores respondem na hora com o status uploading enquanto a importação continua em segundo plano. Você pode acompanhar o progresso com GET /api/v1/transfers/{id}/import ou simplesmente esperar o webhook transfer.ready. É assim também que as integrações com Zapier e Make enviam arquivos sem que o seu fluxo precise baixá-los antes.
Webhooks e notificações
Em vez de consultar a API o tempo todo, assine eventos. A Pandafile pode chamar a sua URL quando uma transferência fica pronta, é baixada ou expira, quando um destinatário aprova arquivos ou pede alterações, quando alguém envia arquivos para um dos seus pedidos de arquivos e quando um pedido de assinatura é concluído. Cada entrega é assinada com HMAC-SHA256 em um cabeçalho Pandafile-Signature, para você conferir que veio mesmo de nós, e as entregas que falham são repetidas depois de 1 minuto, 5 minutos, 30 minutos, 2 horas e 12 horas. Os eventos também ficam guardados por 30 dias e podem ser lidos com GET /api/v1/events. Se você não precisa de código nenhum, esses mesmos eventos podem postar mensagens no Slack, no Microsoft Teams ou no Discord.
Chaves de teste, repetições seguras e o que mais dá para automatizar
As chaves de API têm dois modos. As chaves de produção começam com pf_live_ e as de teste com pf_test_. Transferências feitas com uma chave de teste nunca enviam e-mails, nunca contam no seu armazenamento ou uso, ficam guardadas só por 24 horas e não aparecem na sua lista normal de transferências, então você pode rodar testes de integração contra a API real sem efeitos colaterais. Requisições POST e PATCH aceitam um cabeçalho Idempotency-Key, então uma requisição repetida nunca cria uma segunda transferência. Além das transferências, a API cobre destinatários e lembretes, histórico de downloads, estatísticas do link e aprovações, pedidos de arquivos, pedidos de assinatura, personalização da marca e convites para a equipe. A API está incluída no Pro, a partir de $5,99 por mês ou $49,99 por ano, e no Team, a partir de $14,99 por mês ou $129,99 por ano. Em uma equipe, cada membro tem as próprias chaves pessoais.
Guia para desenvolvedores · Referência da API · Documento OpenAPI 3.1
Perguntas frequentes
A Pandafile tem API?
Sim. A Pandafile tem uma API REST em /api/v1 para criar transferências, enviar arquivos, gerenciar destinatários, pedidos de arquivos e pedidos de assinatura, e receber webhooks. Ela está incluída nos planos Pro e Team.
Onde fica a documentação da API?
O guia para desenvolvedores fica em /developers e a referência completa da API, com exemplos, em /developers/api. O documento OpenAPI 3.1 legível por máquina é público em /api/v1/openapi.json.
Os uploads continuam se a conexão cair?
Sim. Os arquivos são enviados com o protocolo tus para uploads retomáveis, então um envio interrompido continua de onde parou em vez de começar do zero.
Posso testar sem enviar e-mails de verdade?
Sim. Use uma chave de teste que começa com pf_test_. As transferências de teste nunca enviam e-mails, não contam no seu armazenamento ou uso e são excluídas depois de 24 horas.
Posso enviar um arquivo que já está on-line?
Sim. POST /api/v1/transfers/from-url busca arquivos em URLs HTTPS e os transforma em uma transferência. Importações maiores continuam em segundo plano, e o webhook transfer.ready avisa quando o link está pronto.
Ler o guia para desenvolvedores
Populares
- Aprovação de arquivos pelo cliente
- Compartilhamento de arquivos para equipes
- Saiba quem baixou seus arquivos
- Transferência de arquivos com criptografia de ponta a ponta
- Transferência de arquivos para fotógrafos, em qualidade total
- Transferência de arquivos para videomakers e editores
- Transferência de arquivos grátis, até 50 GB
- Enviar arquivos grandes sem complicação
- Enviar vídeos grandes em qualidade original
- Envie um arquivo de 1 GB grátis, em segundos
- Enviar arquivos grandes do iPhone, sem app
- Pandafile vs WeTransfer: uma comparação honesta