Contrats de collecte — Dropbox
01Comment lire cette page #sec_ad073a7d
Chaque ressource que REVIEWIT sait collecter pour Dropbox a un contrat publié. Il se lit comme une référence d'API : ce que REVIEWIT appelle sur le service collecté et par quelle voie, ce que le contrat exige pour que la collecte s'exécute, et les données que REVIEWIT conserve. REVIEWIT ne fait que des lectures.
- Appels : les requêtes que REVIEWIT adresse au service collecté, toutes en lecture.
- Exigences : chacune doit être satisfaite. Sa nature dit ce qu'elle demande : un droit à accorder à l'identifiant, une condition d'administration (un réglage ou une attribution chez le fournisseur que le jeton ne porte pas, constaté par un appel réel en lecture), ou l'appartenance de l'identifiant à l'équipe Dropbox de la connexion. La règle dit combien d'options il faut : « requise » pour l'unique option, « une au choix » quand une seule suffit (elles sont rangées de la plus étroite à la plus large : préférez la première), « toutes », ou « N au choix parmi M ».
- Conditions de fonctionnement : ce que REVIEWIT constate avant chaque collecte, au-delà des exigences.
- Fraîcheur : l'âge maximal des vérifications sur lesquelles le verdict s'appuie, fixé par chaque contrat (ici : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel). REVIEWIT refait automatiquement dans ce délai les vérifications qu'il sait faire (jeton obtenu, service qui répond) ; « Vérifier les droits », dans le menu de la connexion, les refait à la demande. Tant que l'appel réel n'est pas fait, les droits restent non constatés.
- Données conservées : les champs que REVIEWIT garde de chaque objet ; le rôle dit ce que la revue en fait.
Le verdict de chaque ressource, pour votre connexion, se lit sur sa fiche. Une ressource que la connexion ne collecte pas peut toujours être alimentée par l'import d'un rapport (« Importer un rapport »).
02Comment REVIEWIT vérifie les exigences #sec_baec0ba7
Le jeton Dropbox ne porte pas ses droits : le contrat exige qu'ils soient constatés par un appel réel, en lecture. REVIEWIT ne fait pas encore cet appel pour Dropbox : il constate que le jeton est obtenu et que le service répond, mais pas les droits listés ici. Les ressources s'affichent « Non vérifié » ; elles peuvent toujours être alimentées par l'import d'un rapport (« Importer un rapport »).
03Les voies d'appel #sec_aa579778
Une voie dit quel jeton REVIEWIT obtient pour l'identifiant : qui le délivre et pour quelle audience. Les adresses appelées figurent dans les appels de chaque ressource ; un chemin qui commence par « / » s'appelle sur l'audience du jeton de sa voie.
| Voie | Jeton délivré par | Audience du jeton | Authentification de l'identifiant |
|---|---|---|---|
| dropbox.team.reviewit.app | https://api.dropboxapi.com/oauth2/token | https://api.dropboxapi.com | jeton ou secret d'API |
04Directory · Team members #sec_b383ef81
dropbox.directory.members:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Membres de l'équipe, leur statut et leur rôle
Appels
- POST /2/team/members/list_v2
- POST /2/team/members/list/continue_v2
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | members.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| TeamMemberId | clé de l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | oui | |
| DisplayName | affiché pour reconnaître l'objet | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
| Role | contexte, sans effet sur la revue | texte | non |
| JoinedOn | contexte, sans effet sur la revue | date et heure | non |
| ExternalId | contexte, sans effet sur la revue | texte | non |
05Groups #sec_8e4bf902
dropbox.groups.groups:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Groupes d'équipe, gérés par l'entreprise ou par l'utilisateur
Appels
- POST /2/team/groups/list
- POST /2/team/groups/list/continue
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | groups.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| GroupId | clé de l'objet | texte | oui |
| GroupName | affiché pour reconnaître l'objet | texte | oui |
| ManagementType | contexte, sans effet sur la revue | texte | non |
| MemberCount | contexte, sans effet sur la revue | entier | non |
| ExternalId | contexte, sans effet sur la revue | texte | non |
06Groups · Group members #sec_0f3a6cc8
dropbox.groups.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Appartenances de groupe et rôle (membre ou gestionnaire). Clé de ligne : GroupId | TeamMemberId.
Appels
- POST /2/team/groups/members/list
- POST /2/team/groups/members/list/continue
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | groups.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| MembershipKey | clé de l'objet | texte | oui |
| GroupId | contexte, sans effet sur la revue | texte | oui |
| GroupName | contexte, sans effet sur la revue | texte | non |
| TeamMemberId | contexte, sans effet sur la revue | texte | oui |
| affiché pour reconnaître l'objet | texte | oui | |
| AccessType | contexte, sans effet sur la revue | texte | non |
07Privileged roles · Team administrators #sec_2bf483df
dropbox.privileged-roles.admins:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Administrateurs d'équipe et leur périmètre d'administration
Appels
- POST /2/team/members/list_v2 (rôles)
- POST /2/team/members/get_available_team_member_roles
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | members.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| TeamMemberId | clé de l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | oui | |
| DisplayName | affiché pour reconnaître l'objet | texte | non |
| Role | contexte, sans effet sur la revue | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
| JoinedOn | contexte, sans effet sur la revue | date et heure | non |
08Shared content · Share members and invitations #sec_c6e9d19c
dropbox.sharing.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Membres d'un partage et invitations encore en attente. Clé de ligne : SharedFolderId | PrincipalId (compte, groupe ou adresse de l'invité).
Appels
- POST /2/sharing/list_folder_members (au nom de chaque membre)
- POST /2/sharing/list_folder_members/continue (au nom de chaque membre)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | members.read |
| Droit | requise | team_data.member |
| Droit | requise | sharing.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| MembershipKey | clé de l'objet | texte | oui |
| SharedFolderId | contexte, sans effet sur la revue | texte | oui |
| SharedFolderName | contexte, sans effet sur la revue | texte | non |
| PrincipalId | contexte, sans effet sur la revue | texte | oui |
| PrincipalType | contexte, sans effet sur la revue | texte | non |
| affiché pour reconnaître l'objet | texte | oui | |
| AccessType | contexte, sans effet sur la revue | texte | non |
| IsInherited | contexte, sans effet sur la revue | booléen | non |
| InvitationPending | contexte, sans effet sur la revue | booléen | non |
09Shared content · Shared folders #sec_892c126b
dropbox.sharing.shared-folders:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Dossiers partagés, leur propriétaire et leur politique de partage
Appels
- POST /2/sharing/list_folders (au nom de chaque membre)
- POST /2/sharing/list_folders/continue (au nom de chaque membre)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | members.read |
| Droit | requise | team_data.member |
| Droit | requise | sharing.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| SharedFolderId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| PathLower | contexte, sans effet sur la revue | texte | non |
| OwnerTeam | contexte, sans effet sur la revue | texte | non |
| AccessType | contexte, sans effet sur la revue | texte | non |
| IsInsideTeamFolder | contexte, sans effet sur la revue | booléen | non |
| PolicyMemberPolicy | contexte, sans effet sur la revue | texte | non |
10Shared content · Shared links #sec_ef07fa72
dropbox.sharing.shared-links:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Liens de partage : audience, mot de passe, échéance
Appels
- POST /2/sharing/list_shared_links (au nom de chaque membre)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | members.read |
| Droit | requise | team_data.member |
| Droit | requise | sharing.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| LinkId | clé de l'objet | texte | oui |
| Url | affiché pour reconnaître l'objet | texte | oui |
| PathLower | contexte, sans effet sur la revue | texte | non |
| Visibility | évalué par les politiques REVIEWIT (visibilité) | texte | non |
| HasPassword | contexte, sans effet sur la revue | booléen | non |
| Expires | contexte, sans effet sur la revue | date et heure | non |
| CreatedBy | accès soumis à la revue | liste d'identités | non |
11Team spaces · Team folder access #sec_cdb4c7fe
dropbox.team-space.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Groupes et membres ayant accès à un dossier d'équipe. Clé de ligne : TeamFolderId | PrincipalId.
Appels
- POST /2/team/team_folder/list
- POST /2/sharing/list_folder_members (dossiers d'équipe, au nom d'un administrateur)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | team_data.team_space |
| Droit | requise | sharing.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| MembershipKey | clé de l'objet | texte | oui |
| TeamFolderId | contexte, sans effet sur la revue | texte | oui |
| TeamFolderName | affiché pour reconnaître l'objet | texte | oui |
| PrincipalId | contexte, sans effet sur la revue | texte | oui |
| PrincipalType | contexte, sans effet sur la revue | texte | non |
| AccessType | contexte, sans effet sur la revue | texte | non |
| IsInherited | contexte, sans effet sur la revue | booléen | non |
12Team spaces #sec_9bc60b77
dropbox.team-space.namespaces:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Espaces de noms de l'équipe (namespaces) : dossiers de membres, dossiers partagés, dossiers d'équipe et dossiers d'application
Appels
- POST /2/team/namespaces/list
- POST /2/team/namespaces/list/continue
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | une au choix | team_data.member ou team_data.team_space |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| NamespaceId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| NamespaceType | contexte, sans effet sur la revue | texte | non |
| TeamMemberId | contexte, sans effet sur la revue | texte | non |
| IsInsideTeamFolder | contexte, sans effet sur la revue | booléen | non |
13Team spaces · Team folders #sec_42cb5e57
dropbox.team-space.team-folders:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Dossiers d'équipe, leur statut et leur synchronisation
Appels
- POST /2/team/team_folder/list
- POST /2/team/team_folder/list/continue
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | une au choix | team_data.team_space ou team_data.content.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| TeamFolderId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Status | contexte, sans effet sur la revue | texte | non |
| IsTeamSharedDropbox | contexte, sans effet sur la revue | booléen | non |
| SyncSetting | contexte, sans effet sur la revue | texte | non |
| ContentPolicy | contexte, sans effet sur la revue | texte | non |
14Third-party apps · Linked applications #sec_692fcc7b
dropbox.apps.linked-apps:collect · révision 3 du contrat, publiée le 18 octobre 2026 · voie dropbox.team.reviewit.app
Applications tierces associées aux comptes des membres de l'équipe, une ligne par application et par membre. Clé de ligne : TeamMemberId | AppId.
Appels
- POST /2/team/linked_apps/list_members_linked_apps
- POST /2/team/members/get_info_v2 (Email)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | sessions.list |
| Droit | requise | members.read |
| Appartenance | requise | l'identifiant appartient à l'équipe Dropbox de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.dropboxapi.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| LinkKey | clé de l'objet | texte | oui |
| AppId | contexte, sans effet sur la revue | texte | oui |
| AppName | contexte, sans effet sur la revue | texte | non |
| Publisher | contexte, sans effet sur la revue | texte | non |
| TeamMemberId | contexte, sans effet sur la revue | texte | oui |
| affiché pour reconnaître l'objet | texte | oui | |
| LinkedOn | contexte, sans effet sur la revue | date et heure | non |
| IsAppFolder | contexte, sans effet sur la revue | booléen | non |
15Pour aller plus loin #sec_feb78037
- Comprendre une connexion de collecte
- Référence des droits par ressource
- Lire un verdict