Contratos de coleta — Asana
01Como ler esta página #sec_bba4e109
Cada recurso que o REVIEWIT pode coletar para o Asana 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, constatada por uma chamada real em leitura) ou a pertença do identificador à organização Asana 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 constata 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 constatados 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 sob demanda. Enquanto a chamada real não for feita, os direitos permanecem não constatados.
- 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_4b0123b7
O token Asana não possui seus direitos: o contrato exige que eles sejam constatados por uma chamada real, em leitura. O REVIEWIT ainda não faz essa chamada para o Asana: ele constata que o token é 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_cf8230c1
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 de sua via.
| Via | Token emitido por | Audiência do token | Autenticação do identificador |
|---|---|---|---|
| asana.api.reviewit.service-account | https://app.asana.com | https://app.asana.com/api/1.0 | conta de serviço |
04Directory · Guests #sec_b8689674
asana.directory.guests:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account
Colaboradores externos admitidos na organização
Chamadas
- GET /workspaces/{gid}/workspace_memberships (is_guest)
Exigências
| Natureza | Regra | Opções |
|---|---|---|
| Condição de administração | obrigatória | a conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token dá acesso completo em leitura, constatado por chamada |
| Pertença | obrigatória | o identificador pertence à organização Asana da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://app.asana.com/api/1.0 responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados mantidos
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| Gid | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| exibido para reconhecer o objeto | texto | não | |
| IsActive | contexto, sem efeito sobre a revisão | booleano | não |
| Teams | contexto, sem efeito sobre a revisão | texto | não |
| Projects | contexto, sem efeito sobre a revisão | texto | não |
05Directory · Utilisateurs #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 · Membres du portfolio #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 |
08Rôles privilégiés · Administrateurs #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 |
09Projetos · Membros do projeto #sec_f9f5d31c
asana.projects.memberships:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account
Membros de um projeto e seu nível de acesso. Chave de linha: ProjectGid | UserGid.
Chamadas
- GET /projects/{gid}/project_memberships
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Condição de administração | obrigatória | a conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token concede acesso completo de leitura, verificado por chamada |
| Afiliação | obrigatória | o identificador pertence à organização Asana da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://app.asana.com/api/1.0 responde
Frescura: verificações em menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Função | Tipo | Obrigatório |
|---|---|---|---|
| MembershipKey | chave do objeto | texto | sim |
| ProjectGid | contexto, sem efeito na revisão | texto | sim |
| ProjectName | contexto, sem efeito na revisão | texto | não |
| UserGid | contexto, sem efeito na revisão | texto | sim |
| UserName | contexto, sem efeito na revisão | texto | não |
| exibido para reconhecer o objeto | texto | sim | |
| AccessLevel | contexto, sem efeito na revisão | texto | não |
| IsGuest | contexto, sem efeito na revisão | booleano | não |
10Projetos #sec_82d9dfcf
asana.projects.projects:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account
Projetos da organização, seu proprietário e visibilidade
Chamadas
- GET /workspaces/{gid}/projects
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Condição de administração | obrigatória | a conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token concede acesso completo de leitura, verificado por chamada |
| Afiliação | obrigatória | o identificador pertence à organização Asana da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://app.asana.com/api/1.0 responde
Frescura: verificações em menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Função | Tipo | Obrigatório |
|---|---|---|---|
| Gid | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| Team | contexto, sem efeito na revisão | texto | não |
| Owner | acesso sujeito à revisão | lista de identidades | não |
| Privacy | avaliado pelas políticas REVIEWIT (visibilidade) | texto | não |
| Archived | contexto, sem efeito na revisão | booleano | não |
| Created | contexto, sem efeito na revisão | data e hora | não |
| Modified | avaliado pelas políticas REVIEWIT (data da última atividade) | data e hora | não |
| Members | acesso sujeito à revisão | lista de identidades | não |
| Followers | acesso sujeito à revisão | lista de identidades | não |
11Equipes · Membros da equipe #sec_3fa08c09
asana.teams.memberships:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account
Associações de equipe, convidados e acesso limitado incluídos. Chave de linha: TeamGid | UserGid.
Chamadas
- GET /teams/{gid}/team_memberships
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Condição de administração | obrigatória | a conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token concede acesso completo de leitura, verificado por chamada |
| Afiliação | obrigatória | o identificador pertence à organização Asana da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://app.asana.com/api/1.0 responde
Frescura: verificações em menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Função | Tipo | Obrigatório |
|---|---|---|---|
| MembershipKey | chave do objeto | texto | sim |
| TeamGid | contexto, sem efeito na revisão | texto | sim |
| TeamName | contexto, sem efeito na revisão | texto | não |
| UserGid | contexto, sem efeito na revisão | texto | sim |
| UserName | contexto, sem efeito na revisão | texto | não |
| exibido para reconhecer o objeto | texto | sim | |
| IsAdmin | contexto, sem efeito na revisão | booleano | não |
| IsGuest | contexto, sem efeito na revisão | booleano | não |
| IsLimitedAccess | contexto, sem efeito na revisão | booleano | não |
12Equipes #sec_29bcc8ef
asana.teams.teams:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account
Equipes da organização e sua visibilidade
Chamadas
- GET /workspaces/{gid}/teams
- GET /teams/{gid}/team_memberships
Requisitos
| Natureza | Regra | Opções |
|---|---|---|
| Condição de administração | obrigatória | a conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token concede acesso completo de leitura, verificado por chamada |
| Afiliação | obrigatória | o identificador pertence à organização Asana da conexão |
Condições de funcionamento
- um token é obtido para o identificador
- o serviço https://app.asana.com/api/1.0 responde
Frescura: verificações em menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Função | Tipo | Obrigatório |
|---|---|---|---|
| Gid | chave do objeto | texto | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| Description | contexto, sem efeito na revisão | texto | não |
| Visibility | avaliado pelas políticas REVIEWIT (visibilidade) | texto | não |
| Organization | contexto, sem efeito na revisão | texto | não |
| MemberCount | contexto, sem efeito na revisão | inteiro | não |
13Para ir mais longe #sec_b2bf5f50
- Compreender uma ligação de coleta
- Referência dos direitos por recurso
- Ler um veredicto