Chaves de API, permissões e modo de teste

4 min de leitura · Atualizado em 2026-11-15

Resposta rápida

No Pro e no Team, crie chaves de API em Painel > Domínio e API. Cada chave tem uma permissão (Somente leitura, Leitura e escrita ou Acesso total) e um modo: chaves de produção (pf_live_) funcionam de verdade, e chaves de teste (pf_test_) nunca mandam e-mail e suas transferências expiram em 24 horas.

A API do Pandafile permite que seus próprios apps, scripts e servidores enviem arquivos, recebam uploads e peçam assinaturas. Ela está incluída no Pro e no Team e segue os mesmos limites do site. Tudo começa com uma chave de API.

Criar uma chave

  1. Entre na sua conta e abra Painel > Domínio e API.
  2. Em Chaves de API, dê um nome à chave, por exemplo Uploads do site.
  3. Escolha o modo da chave, Produção ou Teste, e o acesso da chave: Acesso total, Leitura e escrita ou Somente leitura.
  4. Clique em Criar chave e copie a chave na hora. Por segurança, ela aparece só uma vez.
  5. Envie a chave em toda requisição no cabeçalho Authorization: Bearer seguido da chave.

Você pode ter até 10 chaves ativas. As chaves de produção começam com pf_live_ e as de teste com pf_test_. O guia para desenvolvedores está em pandafile.co/developers e a referência da API em pandafile.co/developers/api.

Permissões: o que uma chave pode fazer

  • Somente leitura: apenas requisições GET. A chave pode consultar dados, mas não muda nada.
  • Leitura e escrita: tudo o que a Somente leitura faz, mais criar, alterar e excluir transferências, pedidos de arquivos, pedidos de assinatura e assinaturas de webhook.
  • Acesso total: tudo, inclusive as configurações da conta, como a marca e os convites da equipe.

Modo de teste

  • Transferências feitas com uma chave pf_test_ são dados de teste. Ninguém recebe e-mail nunca, nem os destinatários que você adicionar.
  • As transferências de teste sempre expiram 24 horas depois de criadas e não podem ser estendidas.
  • Elas não contam para nenhum limite, armazenamento ou uso, e não aparecem nas suas listas normais de transferências.
  • Os eventos de webhook sobre elas trazem livemode como false e nunca vão para o Slack, Microsoft Teams ou Discord.
  • Algumas ações só funcionam com uma chave de produção. Com uma chave de teste, a API responde com o erro test_mode_unsupported.

Mantenha suas chaves seguras

  • Qualquer pessoa com uma chave pode enviar arquivos da sua conta. Guarde as chaves no seu servidor, nunca no código público de um site ou app.
  • Revogue uma chave em Painel > Domínio e API se ela puder ter vazado. Os apps que a usam param de funcionar na hora, e as assinaturas de webhook criadas com ela, por exemplo pelo Zapier ou pelo Make, também param.
  • Cada chave tem o próprio limite de requisições. Toda resposta mostra em que ponto você está nos cabeçalhos RateLimit.
  • Em uma equipe, as chaves de API são pessoais: cada membro cria as suas.
Pronto para enviar?

Até 50 GB grátis por transferência, sem precisar de conta.

Enviar arquivos