Se você já passou algum tempo em nossa documentação de referência de HTTP, sabe que a API do Dropbox possui uma ampla gama de recursos e funcionalidades. Dado o grande conjunto de ferramentas, pode levar algum tempo para entender como alguns recursos estão conectados. Para ajudar com isso, criamos novos guias do desenvolvedor e renovamos os existentes para preencher algumas dessas lacunas de conhecimento.
Esses guias cobrem tópicos bastante extensos em detalhes – garantindo que, quando os desenvolvedores tiverem um trabalho a fazer, eles possam encontrar todos os conceitos, terminais e considerações que se aplicam a esse tópico específico. Você pode pensar nesses guias como documentos vivos. Continuaremos a iterar e aprimorá-los ao longo do tempo para garantir que todos os construtores tenham as informações mais atualizadas sobre a API do Dropbox.
Guia OAuth
O Guia OAuth oferece informações e orientações sobre como implementar um fluxo OAuth para seu aplicativo Dropbox. Além de uma visão geral do OAuth, o guia inclui seções sobre permissões (escopos e legado), acesso a conteúdo, PKCE, tokens de atualização, tokens de usuário e tokens de equipe. O resumo conciso na parte inferior do guia é uma ótima maneira de identificar qual fluxo OAuth é o correto para seu aplicativo.
Guia de acesso a arquivos
O Guia de acesso a arquivos é um ótimo recurso para aprender a interagir com arquivos e pastas no Dropbox usando a API. O guia explica como os arquivos do Dropbox são representados por metadados e com quais propriedades você normalmente trabalhará. Ele também contém informações sobre como usar diferentes identificadores para interagir com arquivos, percorrer arquivos e pastas, trabalhar com tipos especiais de arquivos e oferece algumas das melhores práticas para trabalhar com arquivos.
Guia de Compartilhamento
O Guia de compartilhamento ensina os leitores a interagir com os recursos de compartilhamento do Dropbox usando a API. Ele cobre links compartilhados, pastas compartilhadas, arquivos compartilhados e algumas das considerações em torno de cada mecanismo exclusivo.
Guia de Extensões
O Guia de extensões ajuda os desenvolvedores a configurar sua própria extensão do Dropbox. O guia orienta os leitores na configuração de sua própria extensão, explica os campos que eles preenchem durante a configuração e explica como usar a extensão (incluindo como os usuários podem adicioná-la ao Dropbox).
Guia de arquivos da equipe
O Guia de Arquivos de Equipe é para ajudar os desenvolvedores a entender como os aplicativos Dropbox vinculados a equipes podem interagir com os arquivos de equipes conectadas. Ele cobre conceitos como namespaces, pastas de equipe, espaços de equipe, gerenciamento de políticas de pasta e listas de controle de acesso. O guia também explica como interagir com os arquivos da equipe usando cabeçalhos como Dropbox-API-Path-Root , Dropbox-API-Select-User e Dropbox-API-Select-Admin .
Guia de administração de equipe
Os desenvolvedores que criam aplicativos que podem gerenciar equipes devem revisar o Guia de Administração de Equipe, que contém informações essenciais para administrar uma equipe por meio da API Dropbox. O guia cobre o gerenciamento de usuários (incluindo o status do usuário), gerenciamento de grupos e outros recursos específicos da equipe, como retenções legais e e-mails secundários.
Guia de Performance
Dentro do Guia de desempenho, você encontrará informações relacionadas ao desempenho da integração do seu aplicativo com a API do Dropbox. O guia cobre limites de taxa, uploads de arquivo, trabalho com arquivos em massa e construção em escala. Ele também contém informações sobre a contenção de bloqueio, que é um erro que pode ocorrer quando vários arquivos estão sendo gravados no Dropbox ao mesmo tempo.
Guia de tratamento de erros
O Guia de tratamento de erros contém informações sobre os diferentes tipos de erros na API do Dropbox e como minimizar seu impacto na experiência do usuário. O guia cobre convenções sobre erros, causas, soluções e práticas recomendadas para lidar com erros comuns.
Guia de detecção de alterações
O Guia de detecção de alterações é valioso para aplicativos que precisam reagir às alterações no Dropbox. Ele cobre ferramentas como polling, longpoll e webhooks que permitem que você faça polling, espere ou seja notificado sobre alterações nos arquivos do usuário. O guia também contém informações sobre como ouvir as alterações nas equipes do Dropbox e usar o registro de eventos da equipe. A tabela na parte inferior adiciona algum contexto sobre quando uma ferramenta específica funcionaria melhor para sua situação.
Ajude a melhorar os guias do desenvolvedor
Você pode pensar nesses guias do desenvolvedor como documentos ativos que são atualizados regularmente para incluir as informações mais recentes sobre a API do Dropbox. Estamos sempre procurando melhorá-los. Você encontrou algo faltando ou identificou um tópico que devemos incluir? Entre em contato, deixe uma mensagem nos comentários abaixo.
Solicite uma trial do Dropbox e conte sempre com o apoio da equipe Figo Sofware!
