Contratti di raccolta — Dropbox
01Come leggere questa pagina #sec_ad073a7d
Ogni risorsa che REVIEWIT può raccogliere per Dropbox ha un contratto pubblicato. Si legge come una referencia API: ciò che REVIEWIT chiama sul servizio raccolto e attraverso quale mezzo, ciò che il contratto richiede affinché la raccolta si esegua e i dati che REVIEWIT conserva. REVIEWIT esegue solo letture.
- Chiamate: le richieste che REVIEWIT invia al servizio raccolto, tutte in lettura.
- Requisiti: ciascuno deve essere soddisfatto. La sua natura indica cosa richiede: un diritto da concedere all'identificativo, una condizione di amministrazione (un'impostazione o un'attribuzione presso il fornitore che il token non porta, verificata da una chiamata reale in lettura) o l'appartenenza dell'identificativo al team Dropbox della connessione. La regola indica quante opzioni sono necessarie: « richiesta » per l'unica opzione, « una a scelta » quando una sola è sufficiente (sono ordinate dalla più ristretta alla più ampia: preferisci la prima), « tutte » o « N a scelta tra M ».
- Condizioni di funzionamento: ciò che REVIEWIT verifica prima di ogni raccolta, oltre ai requisiti.
- Frescura: l'età massima delle verifiche su cui si basa il verdetto, fissata da ogni contratto (qui: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale). REVIEWIT esegue automaticamente entro questo termine le verifiche che sa eseguire (token ottenuto, servizio che risponde); « Verifica i diritti », nel menu della connessione, li esegue su richiesta. Finché la chiamata reale non è stata effettuata, i diritti rimangono non verificati.
- Dati conservati: i campi che REVIEWIT conserva di ogni oggetto; il ruolo indica cosa ne fa la revisione.
Il verdetto di ogni risorsa, per la vostra connessione, si legge sulla sua scheda. Una risorsa che la connessione non raccoglie può comunque essere alimentata dall'import di un rapporto (« Importa un rapporto »).
02Come REVIEWIT verifica i requisiti #sec_baec0ba7
Il token Dropbox non porta i suoi diritti: il contratto richiede che vengano verificati mediante una chiamata reale in lettura. REVIEWIT non effettua ancora questa chiamata per Dropbox: verifica che il token sia ottenuto e che il servizio risponda, ma non i diritti elencati qui. Le risorse vengono visualizzate come « Non verificato »; possono comunque essere alimentate dall'import di un rapporto (« Importare un rapporto »).
03I percorsi di chiamata #sec_aa579778
Un percorso indica quale token REVIEWIT ottiene per l'identificatore: chi lo rilascia e per quale audience. Gli indirizzi chiamati sono indicati nelle chiamate di ogni risorsa; un percorso che inizia con « / » si chiama sull'audience del token del suo percorso.
| Percorso | Token rilasciato da | Audience del token | Autenticazione dell'identificatore |
|---|---|---|---|
| dropbox.team.reviewit.app | https://api.dropboxapi.com/oauth2/token | https://api.dropboxapi.com | token o secret API |
04Directory · Membri del team #sec_b383ef81
dropbox.directory.members:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Membri del team, il loro stato e ruolo
Chiamate
- POST /2/team/members/list_v2
- POST /2/team/members/list/continue_v2
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | richiesto | members.read |
| Appartenenza | richiesto | l'identificativo appartiene al team Dropbox della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Aggiornamento: verifiche di meno di 24 ore; i permessi devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| TeamMemberId | chiave dell'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| DisplayName | visualizzato per riconoscere l'oggetto | testo | no |
| Status | contesto, senza effetto sulla revisione | testo | no |
| Role | contesto, senza effetto sulla revisione | testo | no |
| JoinedOn | contesto, senza effetto sulla revisione | data e ora | no |
| ExternalId | contesto, senza effetto sulla revisione | testo | no |
05Gruppi #sec_8e4bf902
dropbox.groups.groups:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Gruppi di squadra, gestiti dall'azienda o dall'utente
Chiamate
- POST /2/team/groups/list
- POST /2/team/groups/list/continue
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | richiesto | groups.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Freschezza: verifiche inferiori a 24 ore; i permessi devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| GroupId | chiave dell'oggetto | testo | sì |
| GroupName | visualizzato per riconoscere l'oggetto | testo | sì |
| ManagementType | contesto, senza effetto sulla revisione | testo | no |
| MemberCount | contesto, senza effetto sulla revisione | intero | no |
| ExternalId | contesto, senza effetto sulla revisione | testo | no |
06Gruppi · Membri del gruppo #sec_0f3a6cc8
dropbox.groups.memberships:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Appartenenze al gruppo e ruolo (membro o gestore). Chiave di riga: GroupId | TeamMemberId.
Chiamate
- POST /2/team/groups/members/list
- POST /2/team/groups/members/list/continue
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | richiesto | groups.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Freschezza: verifiche inferiori a 24 ore; i permessi devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| GroupId | contesto, senza effetto sulla revisione | testo | sì |
| GroupName | contesto, senza effetto sulla revisione | testo | no |
| TeamMemberId | contesto, senza effetto sulla revisione | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| AccessType | contesto, senza effetto sulla revisione | testo | no |
07Ruoli privilegiati · Amministratori della squadra #sec_2bf483df
dropbox.privileged-roles.admins:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Amministratori della squadra e loro ambito di amministrazione
Chiamate
- POST /2/team/members/list_v2 (ruoli)
- POST /2/team/members/get_available_team_member_roles
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | richiesto | members.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Freschezza: verifiche inferiori a 24 ore; i permessi devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| TeamMemberId | chiave dell'oggetto | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| DisplayName | visualizzato per riconoscere l'oggetto | testo | no |
| Role | contesto, senza effetto sulla revisione | testo | no |
| Status | contesto, senza effetto sulla revisione | testo | no |
| JoinedOn | contesto, senza effetto sulla revisione | data e ora | no |
08Contenuto condiviso · Membri e inviti condivisi #sec_c6e9d19c
dropbox.sharing.memberships:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Membri di una condivisione e inviti ancora in attesa. Chiave di riga: SharedFolderId | PrincipalId (account, gruppo o indirizzo dell'invitato).
Chiamate
- POST /2/sharing/list_folder_members (a nome di ogni membro)
- POST /2/sharing/list_folder_members/continue (a nome di ogni membro)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | richiesto | members.read |
| Permesso | richiesto | team_data.member |
| Permesso | richiesto | sharing.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Freschezza: verifiche inferiori a 24 ore; i permessi devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| SharedFolderId | contesto, senza effetto sulla revisione | testo | sì |
| SharedFolderName | contesto, senza effetto sulla revisione | testo | no |
| PrincipalId | contesto, senza effetto sulla revisione | testo | sì |
| PrincipalType | contesto, senza effetto sulla revisione | testo | no |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| AccessType | contesto, senza effetto sulla revisione | testo | no |
| IsInherited | contesto, senza effetto sulla revisione | booleano | no |
| InvitationPending | contesto, senza effetto sulla revisione | booleano | no |
09Contenuto condiviso · Cartelle condivise #sec_892c126b
dropbox.sharing.shared-folders:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Cartelle condivise, il loro proprietario e la politica di condivisione
Chiamate
- POST /2/sharing/list_folders (a nome di ogni membro)
- POST /2/sharing/list_folders/continue (a nome di ogni membro)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | members.read |
| Diritto | richiesto | team_data.member |
| Diritto | richiesto | sharing.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| SharedFolderId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| PathLower | contesto, senza effetto sulla revisione | testo | no |
| OwnerTeam | contesto, senza effetto sulla revisione | testo | no |
| AccessType | contesto, senza effetto sulla revisione | testo | no |
| IsInsideTeamFolder | contesto, senza effetto sulla revisione | booleano | no |
| PolicyMemberPolicy | contesto, senza effetto sulla revisione | testo | no |
10Contenuto condiviso · Link condivisi #sec_ef07fa72
dropbox.sharing.shared-links:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Link condivisi: pubblico, password, scadenza
Chiamate
- POST /2/sharing/list_shared_links (a nome di ogni membro)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | members.read |
| Diritto | richiesto | team_data.member |
| Diritto | richiesto | sharing.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| LinkId | chiave dell'oggetto | testo | sì |
| Url | visualizzato per riconoscere l'oggetto | testo | sì |
| PathLower | contesto, senza effetto sulla revisione | testo | no |
| Visibility | valutato dalle politiche REVIEWIT (visibilità) | testo | no |
| HasPassword | contesto, senza effetto sulla revisione | booleano | no |
| Expires | contesto, senza effetto sulla revisione | data e ora | no |
| CreatedBy | accesso soggetto alla revisione | lista di identità | no |
11Spazi di squadra · Accesso alla cartella di squadra #sec_cdb4c7fe
dropbox.team-space.memberships:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Gruppi e membri con accesso a una cartella di squadra. Chiave di riga: TeamFolderId | PrincipalId.
Chiamate
- POST /2/team/team_folder/list
- POST /2/sharing/list_folder_members (cartelle di squadra, a nome di un amministratore)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | richiesto | team_data.team_space |
| Diritto | richiesto | sharing.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| MembershipKey | chiave dell'oggetto | testo | sì |
| TeamFolderId | contesto, senza effetto sulla revisione | testo | sì |
| TeamFolderName | visualizzato per riconoscere l'oggetto | testo | sì |
| PrincipalId | contesto, senza effetto sulla revisione | testo | sì |
| PrincipalType | contesto, senza effetto sulla revisione | testo | no |
| AccessType | contesto, senza effetto sulla revisione | testo | no |
| IsInherited | contesto, senza effetto sulla revisione | booleano | no |
12Spazi di squadra #sec_9bc60b77
dropbox.team-space.namespaces:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · via dropbox.team.reviewit.app
Spazi di nome della squadra (namespace): cartelle dei membri, cartelle condivise, cartelle di squadra e cartelle dell'applicazione
Chiamate
- POST /2/team/namespaces/list
- POST /2/team/namespaces/list/continue
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Diritto | una a scelta | team_data.member o team_data.team_space |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- un token è ottenuto per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Freschezza: verifiche di meno di 24 ore; i diritti devono essere verificati da una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| NamespaceId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| NamespaceType | contesto, senza effetto sulla revisione | testo | no |
| TeamMemberId | contesto, senza effetto sulla revisione | testo | no |
| IsInsideTeamFolder | contesto, senza effetto sulla revisione | booleano | no |
13Spazi di squadra · Cartelle di squadra #sec_42cb5e57
dropbox.team-space.team-folders:collect · revisione 2 del contratto, pubblicata il 18 ottobre 2026 · percorso dropbox.team.reviewit.app
Cartelle di squadra, il loro stato e la loro sincronizzazione
Chiamate
- POST /2/team/team_folder/list
- POST /2/team/team_folder/list/continue
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | una tra le scelte | team_data.team_space o team_data.content.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Aggiornamento: verifiche inferiori a 24 ore; i permessi devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| TeamFolderId | chiave dell'oggetto | testo | sì |
| Name | visualizzato per riconoscere l'oggetto | testo | sì |
| Status | contesto, senza effetto sulla revisione | testo | no |
| IsTeamSharedDropbox | contesto, senza effetto sulla revisione | booleano | no |
| SyncSetting | contesto, senza effetto sulla revisione | testo | no |
| ContentPolicy | contesto, senza effetto sulla revisione | testo | no |
14App di terze parti · Applicazioni collegate #sec_692fcc7b
dropbox.apps.linked-apps:collect · revisione 3 del contratto, pubblicata il 18 ottobre 2026 · percorso dropbox.team.reviewit.app
Applicazioni di terze parti collegate ai conti dei membri della squadra, una riga per applicazione e per membro. Chiave della riga: TeamMemberId | AppId.
Chiamate
- POST /2/team/linked_apps/list_members_linked_apps
- POST /2/team/members/get_info_v2 (Email)
Requisiti
| Natura | Regola | Opzioni |
|---|---|---|
| Permesso | richiesto | sessions.list |
| Permesso | richiesto | members.read |
| Appartenenza | richiesto | l'identificativo appartiene alla squadra Dropbox della connessione |
Condizioni di funzionamento
- viene ottenuto un token per l'identificativo
- il servizio https://api.dropboxapi.com risponde
Aggiornamento: verifiche inferiori a 24 ore; i permessi devono essere verificati con una chiamata reale.
Dati conservati
| Campo | Ruolo | Tipo | Obbligatorio |
|---|---|---|---|
| LinkKey | chiave dell'oggetto | testo | sì |
| AppId | contesto, senza effetto sulla revisione | testo | sì |
| AppName | contesto, senza effetto sulla revisione | testo | no |
| Publisher | contesto, senza effetto sulla revisione | testo | no |
| TeamMemberId | contesto, senza effetto sulla revisione | testo | sì |
| visualizzato per riconoscere l'oggetto | testo | sì | |
| LinkedOn | contesto, senza effetto sulla revisione | data e ora | no |
| IsAppFolder | contesto, senza effetto sulla revisione | booleano | no |
15Per andare oltre #sec_feb78037
- Comprendere una connessione di raccolta
- Riferimento dei permessi per risorsa
- Leggere un verdetto