Chaves de API, permissões e modo de teste
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
- Entre na sua conta e abra Painel > Domínio e API.
- Em Chaves de API, dê um nome à chave, por exemplo Uploads do site.
- Escolha o modo da chave, Produção ou Teste, e o acesso da chave: Acesso total, Leitura e escrita ou Somente leitura.
- Clique em Criar chave e copie a chave na hora. Por segurança, ela aparece só uma vez.
- 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.