Contratos de coleta — Dropbox
01Como ler esta página #sec_ad073a7d
Cada recurso que o REVIEWIT pode coletar para o Dropbox tem um contrato publicado. Ele é lido como uma referência de API: o que o REVIEWIT chama no serviço coletado e por qual meio, o que o contrato exige para que a coleta seja executada e os dados que o REVIEWIT mantém. O REVIEWIT apenas realiza leituras.
- Chamadas: as requisições que o REVIEWIT faz ao serviço coletado, todas em leitura.
- Exigências: cada uma deve ser satisfeita. Sua natureza indica o que ela solicita: um direito a conceder ao identificador, uma condição de administração (uma configuração ou atribuição no fornecedor que o token não possui, verificada por uma chamada real em leitura) ou a pertença do identificador à equipe do Dropbox da conexão. A regra indica quantas opções são necessárias: « obrigatória » para a única opção, « uma à escolha » quando uma única basta (elas são ordenadas da mais estreita à mais ampla: prefira a primeira), « todas » ou « N à escolha entre M ».
- Condições de funcionamento: o que o REVIEWIT verifica antes de cada coleta, além das exigências.
- Frescura: a idade máxima das verificações nas quais o veredicto se baseia, definida por cada contrato (aqui: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real). O REVIEWIT refaz automaticamente dentro desse prazo as verificações que ele sabe fazer (token obtido, serviço que responde); « Verificar os direitos », no menu da conexão, os refaz a pedido. Enquanto a chamada real não for feita, os direitos permanecem não verificados.
- Dados mantidos: os campos que o REVIEWIT mantém de cada objeto; o papel indica o que a revisão faz com eles.
O veredicto de cada recurso, para sua conexão, é lido em sua ficha. Um recurso que a conexão não coleta pode sempre ser alimentado pela importação de um relatório (« Importar um relatório »).
02Como o REVIEWIT verifica as exigências #sec_baec0ba7
O token do Dropbox não possui seus direitos: o contrato exige que eles sejam verificados por uma chamada real, em leitura. O REVIEWIT ainda não faz essa chamada para o Dropbox: ele verifica que o token foi obtido e que o serviço responde, mas não os direitos listados aqui. Os recursos são exibidos como « Não verificado »; eles podem sempre ser alimentados pela importação de um relatório (« Importar um relatório »).
03As vias de chamada #sec_aa579778
Uma via indica qual token o REVIEWIT obtém para o identificador: quem o emite e para qual audiência. Os endereços chamados aparecem nas chamadas de cada recurso; um caminho que começa com « / » é chamado na audiência do token da sua via.
| Via | Token emitido por | Audiência do token | Autenticação do identificador |
|---|---|---|---|
| dropbox.team.reviewit.app | https://api.dropboxapi.com/oauth2/token | https://api.dropboxapi.com | token ou segredo de API |
04Directory · Membros da equipe #sec_b383ef81
dropbox.directory.members:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Membros da equipe, seu status e papel
Chamadas
- POST /2/team/members/list_v2
- POST /2/team/members/list/continue_v2
Exigências
| Natureza | Regra | Opções |
|---|---|---|
| Direito | obrigatória | members.read |
| Pertença | obrigatória | o identificador pertence à equipe do Dropbox da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| TeamMemberId | chave do objeto | texto | sim |
| exibido para reconhecer o objeto | texto | sim | |
| DisplayName | exibido para reconhecer o objeto | texto | não |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| Role | contexto, sem efeito sobre a revisão | texto | não |
| JoinedOn | contexto, sem efeito sobre a revisão | data e hora | não |
| ExternalId | contexto, sem efeito sobre a revisão | texto | não |
05Grupos #sec_8e4bf902
dropbox.groups.groups:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Grupos de equipa, geridos pela empresa ou pelo utilizador
Chamadas
- POST /2/team/groups/list
- POST /2/team/groups/list/continue
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | groups.read |
| Afiliação | requerido | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| GroupId | chave do objeto | texto | sim |
| GroupName | exibido para reconhecer o objeto | texto | sim |
| ManagementType | contexto, sem efeito sobre a revisão | texto | não |
| MemberCount | contexto, sem efeito sobre a revisão | inteiro | não |
| ExternalId | contexto, sem efeito sobre a revisão | texto | não |
06Grupos · Membros do grupo #sec_0f3a6cc8
dropbox.groups.memberships:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Afiliações de grupo e papel (membro ou gestor). Chave de linha: GroupId | TeamMemberId.
Chamadas
- POST /2/team/groups/members/list
- POST /2/team/groups/members/list/continue
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | groups.read |
| Afiliação | requerido | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| MembershipKey | chave do objeto | texto | sim |
| GroupId | contexto, sem efeito sobre a revisão | texto | sim |
| GroupName | contexto, sem efeito sobre a revisão | texto | não |
| TeamMemberId | contexto, sem efeito sobre a revisão | texto | sim |
| exibido para reconhecer o objeto | texto | sim | |
| AccessType | contexto, sem efeito sobre a revisão | texto | não |
07Papéis privilegiados · Administradores da equipa #sec_2bf483df
dropbox.privileged-roles.admins:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Administradores da equipa e o seu âmbito de administração
Chamadas
- POST /2/team/members/list_v2 (papéis)
- POST /2/team/members/get_available_team_member_roles
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | members.read |
| Afiliação | requerido | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| TeamMemberId | chave do objeto | texto | sim |
| exibido para reconhecer o objeto | texto | sim | |
| DisplayName | exibido para reconhecer o objeto | texto | não |
| Role | contexto, sem efeito sobre a revisão | texto | não |
| Status | contexto, sem efeito sobre a revisão | texto | não |
| JoinedOn | contexto, sem efeito sobre a revisão | data e hora | não |
08Conteúdo partilhado · Membros e convites de partilha #sec_c6e9d19c
dropbox.sharing.memberships:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Membros de uma partilha e convites ainda pendentes. Chave de linha: SharedFolderId | PrincipalId (conta, grupo ou endereço do convidado).
Chamadas
- POST /2/sharing/list_folder_members (em nome de cada membro)
- POST /2/sharing/list_folder_members/continue (em nome de cada membro)
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | members.read |
| Direito | requerido | team_data.member |
| Direito | requerido | sharing.read |
| Afiliação | requerido | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| MembershipKey | chave do objeto | texto | sim |
| SharedFolderId | contexto, sem efeito sobre a revisão | texto | sim |
| SharedFolderName | contexto, sem efeito sobre a revisão | texto | não |
| PrincipalId | contexto, sem efeito sobre a revisão | texto | sim |
| PrincipalType | contexto, sem efeito sobre a revisão | texto | não |
| exibido para reconhecer o objeto | texto | sim | |
| AccessType | contexto, sem efeito sobre a revisão | texto | não |
| IsInherited | contexto, sem efeito sobre a revisão | booleano | não |
| InvitationPending | contexto, sem efeito sobre a revisão | booleano | não |
09Conteúdo partilhado · Pastas partilhadas #sec_892c126b
dropbox.sharing.shared-folders:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Pastas partilhadas, seu proprietário e política de partilha
Chamadas
- POST /2/sharing/list_folders (em nome de cada membro)
- POST /2/sharing/list_folders/continue (em nome de cada membro)
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | members.read |
| Direito | requerido | team_data.member |
| Direito | requerido | sharing.read |
| Afiliação | requerido | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| SharedFolderId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| PathLower | contexto, sem efeito sobre a revisão | texto | não |
| OwnerTeam | contexto, sem efeito sobre a revisão | texto | não |
| AccessType | contexto, sem efeito sobre a revisão | texto | não |
| IsInsideTeamFolder | contexto, sem efeito sobre a revisão | booleano | não |
| PolicyMemberPolicy | contexto, sem efeito sobre a revisão | texto | não |
10Conteúdo partilhado · Ligações partilhadas #sec_ef07fa72
dropbox.sharing.shared-links:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Ligações de partilha: audiência, palavra-passe, validade
Chamadas
- POST /2/sharing/list_shared_links (em nome de cada membro)
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | members.read |
| Direito | requerido | team_data.member |
| Direito | requerido | sharing.read |
| Afiliação | requerido | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| LinkId | chave do objeto | texto | sim |
| Url | exibido para reconhecer o objeto | texto | sim |
| PathLower | contexto, sem efeito sobre a revisão | texto | não |
| Visibility | avaliado pelas políticas REVIEWIT (visibilidade) | texto | não |
| HasPassword | contexto, sem efeito sobre a revisão | booleano | não |
| Expires | contexto, sem efeito sobre a revisão | data e hora | não |
| CreatedBy | acesso sujeito à revisão | lista de identidades | não |
11Espaços de equipa · Acesso a pastas de equipa #sec_cdb4c7fe
dropbox.team-space.memberships:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Grupos e membros com acesso a uma pasta de equipa. Chave da linha: TeamFolderId | PrincipalId.
Chamadas
- POST /2/team/team_folder/list
- POST /2/sharing/list_folder_members (pastas de equipa, em nome de um administrador)
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerido | team_data.team_space |
| Direito | requerido | sharing.read |
| Afiliação | requerido | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| MembershipKey | chave do objeto | texto | sim |
| TeamFolderId | contexto, sem efeito sobre a revisão | texto | sim |
| TeamFolderName | exibido para reconhecer o objeto | texto | sim |
| PrincipalId | contexto, sem efeito sobre a revisão | texto | sim |
| PrincipalType | contexto, sem efeito sobre a revisão | texto | não |
| AccessType | contexto, sem efeito sobre a revisão | texto | não |
| IsInherited | contexto, sem efeito sobre a revisão | booleano | não |
12Espaços de equipa #sec_9bc60b77
dropbox.team-space.namespaces:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Espaços de nomes da equipa (namespaces): pastas de membros, pastas partilhadas, pastas de equipa e pastas de aplicação
Chamadas
- POST /2/team/namespaces/list
- POST /2/team/namespaces/list/continue
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | uma a escolher | team_data.member ou team_data.team_space |
| Afiliação | requerido | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| NamespaceId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| NamespaceType | contexto, sem efeito sobre a revisão | texto | não |
| TeamMemberId | contexto, sem efeito sobre a revisão | texto | não |
| IsInsideTeamFolder | contexto, sem efeito sobre a revisão | booleano | não |
13Espaços de equipa · Pastas de equipa #sec_42cb5e57
dropbox.team-space.team-folders:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Pastas de equipa, seu estado e sincronização
Chamadas
- POST /2/team/team_folder/list
- POST /2/team/team_folder/list/continue
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | uma à escolha | team_data.team_space ou team_data.content.read |
| Afiliação | requerida | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Função | Tipo | Obrigatório |
|---|---|---|---|
| TeamFolderId | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| Status | contexto, sem efeito na revisão | texto | não |
| IsTeamSharedDropbox | contexto, sem efeito na revisão | booleano | não |
| SyncSetting | contexto, sem efeito na revisão | texto | não |
| ContentPolicy | contexto, sem efeito na revisão | texto | não |
14Aplicações de terceiros · Aplicações vinculadas #sec_692fcc7b
dropbox.apps.linked-apps:collect · revisão 3 do contrato, publicada em 18 de outubro de 2026 · via dropbox.team.reviewit.app
Aplicações de terceiros associadas às contas dos membros da equipa, uma linha por aplicação e por membro. Chave da linha: TeamMemberId | AppId.
Chamadas
- POST /2/team/linked_apps/list_members_linked_apps
- POST /2/team/members/get_info_v2 (Email)
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Direito | requerida | sessions.list |
| Direito | requerida | members.read |
| Afiliação | requerida | o identificador pertence à equipa Dropbox da ligação |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://api.dropboxapi.com responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Função | Tipo | Obrigatório |
|---|---|---|---|
| LinkKey | chave do objeto | texto | sim |
| AppId | contexto, sem efeito na revisão | texto | sim |
| AppName | contexto, sem efeito na revisão | texto | não |
| Publisher | contexto, sem efeito na revisão | texto | não |
| TeamMemberId | contexto, sem efeito na revisão | texto | sim |
| exibido para reconhecer o objeto | texto | sim | |
| LinkedOn | contexto, sem efeito na revisão | data e hora | não |
| IsAppFolder | contexto, sem efeito na revisão | booleano | não |
15Para ir mais longe #sec_feb78037
- Compreender uma ligação de coleta
- Referência dos direitos por recurso
- Ler um veredicto