Skip to main content
Envie sua chave secreta no cabeçalho de cada requisição:
A chave determina a conta. Não é necessário enviar um ID de conta; informar outra conta não amplia o acesso. Use HTTPS e mantenha a chave no servidor, fora do código de navegador, aplicativos distribuídos, URLs e repositórios.

Permissões

As permissões de leitura e escrita são independentes. write não concede read automaticamente. Escolha apenas as permissões necessárias. Cada operação informa o escopo que aceita; a permissão global correspondente também é válida. Uma permissão não cria métodos que o recurso não oferece.

Validade e revogação

Chaves expiradas ou revogadas não autenticam. As chaves pertencem ao usuário e ficam restritas à conta em que foram criadas. Remover ou desativar o acesso do usuário à conta revoga suas chaves permanentemente. Consulte API keys para criação, rotação e revogação.

Dados privados

URLs temporárias de upload e download dão acesso ao conteúdo e devem ser tratadas como credenciais. Não registre tokens, cabeçalhos de autorização ou documentos de clientes em logs. Na integração de webhooks, valide a assinatura da entrega antes de processar o evento.

Diagnóstico

401 indica credencial inválida, expirada, revogada ou uma forma de autenticação não aceita. 403 indica falta de acesso ou permissão. Guarde o cabeçalho X-Request-Id para localizar a chamada; veja Erros.