Contrats de collecte — Asana
01Comment lire cette page #sec_bba4e109
Chaque ressource que REVIEWIT sait collecter pour Asana 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'organisation Asana 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_4b0123b7
Le jeton Asana 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 Asana : 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_cf8230c1
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 |
|---|---|---|---|
| asana.api.reviewit.service-account | https://app.asana.com | https://app.asana.com/api/1.0 | compte de service |
04Directory · Guests #sec_b8689674
asana.directory.guests:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Collaborateurs externes admis dans l'organisation
Appels
- GET /workspaces/{gid}/workspace_memberships (is_guest)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
|---|---|---|---|
| Gid | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| IsActive | contexte, sans effet sur la revue | booléen | non |
| Teams | contexte, sans effet sur la revue | texte | non |
| Projects | contexte, sans effet sur la revue | texte | non |
05Directory · Users #sec_1061454b
asana.directory.users:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Comptes de l'organisation et leur état d'activité
Appels
- GET /workspaces/{gid}/users
- GET /workspaces/{gid}/workspace_memberships
- GET /users/{user_gid}/teams?organization={gid} (champ Teams)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
|---|---|---|---|
| Gid | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| IsActive | contexte, sans effet sur la revue | booléen | non |
| IsAdmin | contexte, sans effet sur la revue | booléen | non |
| IsGuest | contexte, sans effet sur la revue | booléen | non |
| Teams | contexte, sans effet sur la revue | texte | non |
06Portfolios · Portfolio members #sec_bdfc2222
asana.portfolios.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Membres d'un portefeuille et leur niveau d'accès. Clé de ligne : PortfolioGid | UserGid.
Appels
- GET /portfolios/{gid}/portfolio_memberships
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
| PortfolioGid | contexte, sans effet sur la revue | texte | oui |
| PortfolioName | contexte, sans effet sur la revue | texte | non |
| UserGid | contexte, sans effet sur la revue | texte | oui |
| UserName | contexte, sans effet sur la revue | texte | non |
| affiché pour reconnaître l'objet | texte | oui | |
| AccessLevel | contexte, sans effet sur la revue | texte | non |
07Portfolios #sec_c80b6d56
asana.portfolios.portfolios:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Portefeuilles, leur propriétaire, leurs membres et le nombre de projets qu'ils regroupent
Appels
- GET /portfolios?workspace={gid}
- GET /portfolios/{gid}/items
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
|---|---|---|---|
| Gid | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Owner | accès soumis à la revue | liste d'identités | non |
| Public | évalué par les politiques REVIEWIT (visibilité) | booléen | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| Members | accès soumis à la revue | liste d'identités | non |
| ProjectCount | contexte, sans effet sur la revue | entier | non |
08Privileged roles · Administrators #sec_901c7249
asana.privileged-roles.admins:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Administrateurs de l'organisation
Appels
- GET /workspaces/{gid}/workspace_memberships (is_admin)
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
|---|---|---|---|
| Gid | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| AdminScope | contexte, sans effet sur la revue | texte | non |
| IsActive | contexte, sans effet sur la revue | booléen | non |
09Projects · Project members #sec_f9f5d31c
asana.projects.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Membres d'un projet et leur niveau d'accès. Clé de ligne : ProjectGid | UserGid.
Appels
- GET /projects/{gid}/project_memberships
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
| ProjectGid | contexte, sans effet sur la revue | texte | oui |
| ProjectName | contexte, sans effet sur la revue | texte | non |
| UserGid | contexte, sans effet sur la revue | texte | oui |
| UserName | contexte, sans effet sur la revue | texte | non |
| affiché pour reconnaître l'objet | texte | oui | |
| AccessLevel | contexte, sans effet sur la revue | texte | non |
| IsGuest | contexte, sans effet sur la revue | booléen | non |
10Projects #sec_82d9dfcf
asana.projects.projects:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Projets de l'organisation, leur propriétaire et leur visibilité
Appels
- GET /workspaces/{gid}/projects
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
|---|---|---|---|
| Gid | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Team | contexte, sans effet sur la revue | texte | non |
| Owner | accès soumis à la revue | liste d'identités | non |
| Privacy | évalué par les politiques REVIEWIT (visibilité) | texte | non |
| Archived | contexte, sans effet sur la revue | booléen | non |
| Created | contexte, sans effet sur la revue | date et heure | non |
| Modified | évalué par les politiques REVIEWIT (date de dernière activité) | date et heure | non |
| Members | accès soumis à la revue | liste d'identités | non |
| Followers | accès soumis à la revue | liste d'identités | non |
11Teams · Team members #sec_3fa08c09
asana.teams.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Appartenances d'équipe, invités et accès limités compris. Clé de ligne : TeamGid | UserGid.
Appels
- GET /teams/{gid}/team_memberships
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
| TeamGid | contexte, sans effet sur la revue | texte | oui |
| TeamName | contexte, sans effet sur la revue | texte | non |
| UserGid | contexte, sans effet sur la revue | texte | oui |
| UserName | contexte, sans effet sur la revue | texte | non |
| affiché pour reconnaître l'objet | texte | oui | |
| IsAdmin | contexte, sans effet sur la revue | booléen | non |
| IsGuest | contexte, sans effet sur la revue | booléen | non |
| IsLimitedAccess | contexte, sans effet sur la revue | booléen | non |
12Teams #sec_29bcc8ef
asana.teams.teams:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account
Équipes de l'organisation et leur visibilité
Appels
- GET /workspaces/{gid}/teams
- GET /teams/{gid}/team_memberships
Exigences
| Nature | Règle | Options |
|---|---|---|
| Condition d'administration | requise | le compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel |
| Appartenance | requise | l'identifiant appartient à l'organisation Asana de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://app.asana.com/api/1.0 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 |
|---|---|---|---|
| Gid | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Description | contexte, sans effet sur la revue | texte | non |
| Visibility | évalué par les politiques REVIEWIT (visibilité) | texte | non |
| Organization | contexte, sans effet sur la revue | texte | non |
| MemberCount | contexte, sans effet sur la revue | entier | non |
13Pour aller plus loin #sec_b2bf5f50
- Comprendre une connexion de collecte
- Référence des droits par ressource
- Lire un verdict