Novos e aprimorados guias de desenvolvedores

Oi pessoal! Se você passou algum tempo em nossa documentação de referência HTTP, então você sabe que a API do Dropbox tem uma ampla gama de recursos e funcionalidade. 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 de desenvolvedores e renovamos os existentes para preencher algumas dessas lacunas de conhecimento.

Esses guias cobrem tópicos bastante grandes em detalhes — garantindo que, quando os desenvolvedores têm um trabalho a fazer, eles possam encontrar todos os conceitos, pontos finais e considerações que se aplicam a esse tópico específico. Você pode pensar nesses guias como documentos vivos. Continuaremos a iterá-los 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 o seu aplicativo Dropbox. Além de uma visão geral do OAuth, o guia inclui seções sobre permissões (escopos e legados), 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 o seu aplicativo.

Guia de acesso ao arquivo

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 dropbox são representados por metadados e com quais propriedades você normalmente trabalhará. Ele também contém informações sobre o uso de diferentes identificadores para interagir com arquivos, atravessar arquivos e pastas, trabalhar com tipos especiais de arquivos e oferece algumas práticas recomendadas em torno de trabalhar com arquivos.

Guia de Compartilhamento

O Guia de Compartilhamento ensina os leitores a interagir com 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 único.

Guia de Extensões

O Guia de Extensões auxilia os desenvolvedores na criação de sua própria extensão Dropbox. O guia orienta os leitores através da 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 seu Dropbox).

Guia de Arquivos da Equipe

O Guia de Arquivos da Equipe é para ajudar os desenvolvedores a entender como aplicativos dropbox vinculados à equipe podem interagir com os arquivos das equipes conectadas. Ele abrange conceitos como namespaces, pastas de equipe, espaços de equipe, gerenciamento de políticas de pastas e listas de controle de acesso. O guia também explica como interagir com arquivos de equipe usando cabeçalhos como Dropbox-API-Path-Root, Dropbox-API-Select-Usere Dropbox-API-Select-Admin.

Guia de Administração de Equipes

Os desenvolvedores que constroem aplicativos que podem gerenciar equipes devem revisar o Guia de Administração da Equipe, que contém informações essenciais para administrar uma equipe através da API do Dropbox. O guia abrange o gerenciamento de usuários (incluindo status do usuário), gerenciamento de grupo e outros recursos específicos da equipe, como retenções legais e e-mails secundários.

Guia de Desempenho

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 arquivos, 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 manipulação 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 abrange convenções sobre erros, causas, resoluções e melhores práticas para lidar com erros comuns.

Guia de alterações de detecção

O Guia de Detectar alterações é valioso para aplicativos que precisam reagir às alterações no Dropbox. Ele cobre ferramentas como pesquisas, pesquisas longpoll e webhooks que permitem que você vote, espere ou seja notificado de alterações nos arquivos do usuário. O guia também contém informações sobre ouvir mudanças nas equipes do Dropbox e usar o registro de eventos da equipe. A tabela na parte inferior adiciona algum contexto em torno de quando uma ferramenta específica funcionaria melhor para a sua situação.

Ajude a melhorar os guias do desenvolvedor

Você pode pensar nesses guias de desenvolvedor como documentos vivos que são atualizados regularmente para incluir as informações mais recentes sobre a API do Dropbox. Estamos sempre procurando melhorá-los. Encontrou algo faltando ou identificou um tópico que devemos incluir? Por favor, esponte-nos e avise-nos! Você pode entrar em contato conosco no Twitter,postar em nosso fórum de desenvolvedores, ou nos enviar uma mensagem diretamente.

Solicite uma trial do Dropbox e conte sempre com o apoio da equipe Figo Sofware!

Deixe uma resposta