REVIEWITDocumentación
Esta página se genera a partir de Catalogue publié — GitHub — no se corrige a mano.Corregir el contrato corrige la página. Modificarla aquí se perdería en la próxima generación.GENERADA EL 18 octubre 2026 · catalogue v23 · 9869e519
Referencia generadaAl día · generada el 18 octubre 2026

Contratos de recolección — GitHub

Traducción automática, aún no revisadaEsta página fue traducida por un modelo a partir de la versión francesa, que es la que da fe. Leer la versión francesa.

01Cómo leer esta página #sec_59ab4f32

Cada recurso que REVIEWIT puede recolectar para GitHub tiene un contrato publicado. Se lee como una referencia de API: lo que REVIEWIT llama en el servicio recolectado y por qué medio, lo que el contrato exige para que la recolección se ejecute, y los datos que REVIEWIT conserva. REVIEWIT solo realiza lecturas.

  • Llamadas: las solicitudes que REVIEWIT dirige al servicio recolectado, todas en lectura.
  • Exigencias: cada una debe satisfacerse. Su naturaleza indica lo que solicita: un derecho a conceder al identificador, una condición de administración (una configuración o asignación en el proveedor que el token no incluye, comprobada por una llamada real en lectura), o la pertenencia del identificador a la organización GitHub de la conexión. La regla indica cuántas opciones se necesitan: « requerida » para la única opción, « una al elección » cuando una sola es suficiente (están ordenadas de la más estrecha a la más amplia: prefiera la primera), « todas », o « N al elección entre M ».
  • Condiciones de funcionamiento: lo que REVIEWIT comprueba antes de cada recolección, más allá de los requisitos.
  • Frescura: la edad máxima de las verificaciones sobre las que el veredicto se basa, fijada por cada contrato (aquí: verificaciones de menos de 24 h; los derechos deben comprobarse mediante una llamada real). REVIEWIT vuelve a hacer automáticamente dentro de este plazo las verificaciones que puede realizar (token obtenido, servicio que responde); « Verificar los derechos », en el menú de la conexión, los vuelve a hacer bajo demanda. Mientras la llamada real no se haya realizado, los derechos permanecen no comprobados.
  • Datos conservados: los campos que REVIEWIT guarda de cada objeto; el rol indica qué hace la revisión con ellos.

El veredicto de cada recurso, para su conexión, se lee en su ficha. Un recurso que la conexión no recolecta siempre puede ser alimentado por la importación de un informe (« Importar un informe »).

02Cómo REVIEWIT verifica los requisitos #sec_41fe1f52

El token GitHub no incluye sus derechos: el contrato exige que sean comprobados mediante una llamada real, en lectura. REVIEWIT aún no hace esta llamada para GitHub: comprueba que el token está obtenido y que el servicio responde, pero no los derechos listados aquí. Los recursos aparecen como « No verificado »; siempre pueden ser alimentados por la importación de un informe (« Importar un informe »).

03Las vías de llamada #sec_0e4a82cf

Una vía indica qué token REVIEWIT obtiene para el identificador: quién lo emite y para qué audiencia. Las direcciones llamadas aparecen en las llamadas de cada recurso; un camino que comienza con « / » se llama sobre la audiencia del token de su vía.

VíaToken emitido porAudiencia del tokenAutenticación del identificador
github.rest.reviewit.app-installationhttps://api.github.com/app/installations/{installation}/access_tokenshttps://api.github.comclave privada de la App GitHub (JWT firmado, intercambiado por un token de instalación)

En estas direcciones, {installation} es el identificador de la instalación de la App GitHub en la organización.

04Acciones & deployments · Entornos #sec_660a0a3d

github.actions.environments:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Entornos de despliegue y su alcance

Llamadas

  • GET /repos/{owner}/{repo}/environments

Requisitos

NaturalezaReglaOpciones
Derechorequerida« Metadatos: lectura »
Derechouna al elección« Entornos: lectura » o « Acciones: lectura »
Pertenenciarequeridael identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • un token está obtenido para el identificador
  • el servicio https://api.github.com responde

Frescura: verificaciones de menos de 24 h; los derechos deben comprobarse mediante una llamada real.

Datos conservados

CampoRolTipoObligatorio
Idclave del objetoenterosí
RepoFullNamemostrado para reconocer el objetotextosí
EnvironmentNamecontexto, sin efecto sobre la revisióntextono
CreatedAtcontexto, sin efecto sobre la revisiónfecha y horano
UpdatedAtcontexto, sin efecto sobre la revisiónfecha y horano
ProtectionRuleCountcontexto, sin efecto sobre la revisiónenterono

05Acciones y despliegues · Reglas de protección del entorno #sec_d7d51cc9

github.actions.protection-rules:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Reglas de protección de entornos: aprobadores requeridos, tiempo de espera, prohibición de auto-aprobación

Llamadas

  • GET /repos/{owner}/{repo}/environments/{env} (protection_rules, reviewers)
  • GET /repos/{owner}/{repo}/environments/{env}/deployment_protection_rules

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Metadata : lectura »
Permisouna de las opciones« Environments : lectura » o « Actions : lectura »
Pertenenciarequeridael identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
Idclave del objetoenterosí
RepoFullNamemostrado para reconocer el objetotextosí
EnvironmentNamecontexto, sin efecto sobre la revisióntextono
RuleTypecontexto, sin efecto sobre la revisióntextono
ReviewerTypecontexto, sin efecto sobre la revisióntextono
ReviewerLogincontexto, sin efecto sobre la revisióntextono
WaitTimercontexto, sin efecto sobre la revisiónenterono
PreventSelfReviewcontexto, sin efecto sobre la revisiónbooleanono

06Acciones y despliegues · Grupos de ejecutores autoalojados #sec_ccd12501

github.actions.runner-groups:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Grupos de ejecutores autoalojados y los repositorios que acceden a ellos

Llamadas

  • GET /orgs/{org}/actions/runner-groups
  • GET /orgs/{org}/actions/runner-groups/{id}/repositories

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Organization self hosted runners : lectura »
Pertenenciarequeridael identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
RunnerGroupIdclave del objetoenterosí
Namemostrado para reconocer el objetotextosí
Visibilityevaluado por las políticas REVIEWIT (visibilidad)textono
AllowsPublicRepositoriescontexto, sin efecto sobre la revisiónbooleanono
SelectedRepositoriescontexto, sin efecto sobre la revisióntextono
RunnerCountcontexto, sin efecto sobre la revisiónenterono

07Organizaciones · Miembros y colaboradores externos #sec_e6a1a7c9

github.orgs.members:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Miembros directos, cuentas gestionadas (EMU) y colaboradores externos

Llamadas

  • GET /orgs/{org}/members?role=admin
  • GET /orgs/{org}/members?role=member
  • GET /orgs/{org}/members?filter=2fa_disabled
  • GET /orgs/{org}/outside_collaborators
  • GET /users/{username}

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Members : lectura »
Pertenenciarequeridael identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
Idclave del objetoenterosí
Loginmostrado para reconocer el objetotextosí
Namemostrado para reconocer el objetotextono
Emailmostrado para reconocer el objetotextono
OrgLogincontexto, sin efecto sobre la revisióntextono
Rolecontexto, sin efecto sobre la revisióntextono
MembershipTypecontexto, sin efecto sobre la revisióntextono
TwoFactorEnabledcontexto, sin efecto sobre la revisiónbooleanono
SuspendedOncontexto, sin efecto sobre la revisiónfecha y horano

08Organizaciones · Organizaciones #sec_e1d6c322

github.orgs.organizations:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

La organización de la conexión y sus ajustes de acceso (permisión predeterminada de los repositorios, creación de repositorios, autenticación doble)

Llamadas

  • GET /orgs/{org} (parámetros de seguridad y básicos)

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Organization administration : lectura »
Pertenenciarequeridael identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
OrgIdclave del objetoenterosí
Loginmostrado para reconocer el objetotextosí
Namemostrado para reconocer el objetotextono
DefaultRepositoryPermissioncontexto, sin efecto sobre la revisióntextono
MembersCanCreateReposcontexto, sin efecto sobre la revisiónbooleanono
TwoFactorRequiredcontexto, sin efecto sobre la revisiónbooleanono
CreatedOncontexto, sin efecto sobre la revisiónfecha y horano

09Roles privilegiados · Propietarios y administradores #sec_7c3212bc

github.privileged-roles.owners:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Propietarios de la organización (miembros con rol de administrador)

Llamadas

  • GET /orgs/{org}/members?role=admin

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Miembros : lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura : comprobaciones de menos de 24 h ; los derechos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
Idclave del objetoenterosí
Loginmostrado para reconocer el objetotextosí
Namemostrado para reconocer el objetotextono
Emailmostrado para reconocer el objetotextono
Scopecontexto, sin efecto sobre la revisióntextono
RoleNamemostrado para reconocer el objetotextono
OrgLogincontexto, sin efecto sobre la revisióntextono
TwoFactorEnabledcontexto, sin efecto sobre la revisiónbooleanono

10Roles privilegiados · Gestores de seguridad #sec_b29bd864

github.privileged-roles.security-managers:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Equipos con el rol de gestión de seguridad

Llamadas

  • GET /orgs/{org}/organization-roles
  • GET /orgs/{org}/organization-roles/{id}/teams

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Administración de organización : lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura : comprobaciones de menos de 24 h ; los derechos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
Idclave del objetoenterosí
TeamSlugmostrado para reconocer el objetotextosí
TeamNamecontexto, sin efecto sobre la revisióntextono
OrgLogincontexto, sin efecto sobre la revisióntextono
MemberCountcontexto, sin efecto sobre la revisiónenterono
GrantedOncontexto, sin efecto sobre la revisiónfecha y horano

11Proyectos · Proyectos (v2) #sec_e9607f7e

github.projects.projects:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Proyectos de planificación y las cuentas que y acceden

Llamadas

  • POST /graphql (organization.projectsV2)

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Proyectos de organización : lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura : comprobaciones de menos de 24 h ; los derechos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
ProjectIdclave del objetotextosí
Numbercontexto, sin efecto sobre la revisiónenterono
Titlemostrado para reconocer el objetotextosí
Owneracceso sujeto a la revisiónlista de identidadesno
Publicevaluado por las políticas REVIEWIT (visibilidad)booleanono
Closedcontexto, sin efecto sobre la revisiónbooleanono

12Repositórios · Colaboradores del repositorio #sec_638fd686

github.repos.collaborators:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Acceso directo de una cuenta a un repositorio, con su permiso. Clave de línea : RepoFullName | Id.

Llamadas

  • GET /repos/{owner}/{repo}/collaborators?affiliation=direct

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Metadatos : lectura »
Permisorequerido« Administración : lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura : comprobaciones de menos de 24 h ; los derechos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
AccessKeyclave del objetotextosí
Idcontexto, sin efecto sobre la revisiónenterosí
RepoFullNamecontexto, sin efecto sobre la revisióntextosí
Loginmostrado para reconocer el objetotextosí
Namemostrado para reconocer el objetotextono
Permissioncontexto, sin efecto sobre la revisióntextono
RoleNamemostrado para reconocer el objetotextono
IsOutsideCollaboratorcontexto, sin efecto sobre la revisiónbooleanono

13Repositórios #sec_6eb1229a

github.repos.repositories:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Depósitos, su visibilidad, su archivo y su propietario

Llamadas

  • GET /orgs/{org}/repos

Requisitos

NaturalezaReglaOpciones
Derechorequerido« Metadata : lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
RepoIdclave del objetoenterosí
FullNamemostrado para reconocer el objetotextosí
Visibilityevaluado por las políticas REVIEWIT (visibilidad)textono
Archivedcontexto, sin efecto sobre la revisiónbooleanono
Forkcontexto, sin efecto sobre la revisiónbooleanono
DefaultBranchcontexto, sin efecto sobre la revisióntextono
Owneracceso sujeto a la revisiónlista de identidadesno
PushedAtevaluado por las políticas REVIEWIT (fecha de última actividad)fecha y horano
CreatedAtcontexto, sin efecto sobre la revisiónfecha y horano

14Repositórios · Conjuntos de reglas y protección de ramas #sec_0621c1bf

github.repos.rulesets:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Reglas de protección y los actores autorizados para evitarlas

Llamadas

  • GET /repos/{owner}/{repo}/rulesets
  • GET /repos/{owner}/{repo}/branches/{branch}/protection
  • GET /orgs/{org}/rulesets

Requisitos

NaturalezaReglaOpciones
Derechorequerido« Administración : lectura »
Derechorequerido« Administración de organización : lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
RulesetIdclave del objetoenterosí
Namemostrado para reconocer el objetotextosí
Targetcontexto, sin efecto sobre la revisióntextono
Enforcementcontexto, sin efecto sobre la revisióntextono
RepoFullNamecontexto, sin efecto sobre la revisióntextono
BypassActorTypecontexto, sin efecto sobre la revisióntextono
BypassActorIdcontexto, sin efecto sobre la revisióntextono
BypassModecontexto, sin efecto sobre la revisióntextono

15Repositórios · Acceso del equipo al repositorio #sec_f5e716e3

github.repos.team-access:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Acceso de un equipo a un depósito, con su permiso. Clave de fila: RepoFullName | Id.

Llamadas

  • GET /repos/{owner}/{repo}/teams

Requisitos

NaturalezaReglaOpciones
Derechorequerido« Metadata : lectura »
Derechorequerido« Administración : lectura »
Derechorequerido« Miembros : lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
AccessKeyclave del objetotextosí
Idcontexto, sin efecto sobre la revisiónenterosí
RepoFullNamecontexto, sin efecto sobre la revisióntextosí
TeamSlugcontexto, sin efecto sobre la revisióntextono
TeamNamecontexto, sin efecto sobre la revisióntextono
Permissioncontexto, sin efecto sobre la revisióntextono
RoleNamemostrado para reconocer el objetotextosí

16Equipos · Miembros del equipo #sec_3726d567

github.teams.memberships:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Pertenencias del equipo y rol (miembro o mantenedor). Clave de fila: TeamSlug | Id.

Llamadas

  • GET /orgs/{org}/teams/{team}/members?role=maintainer
  • GET /orgs/{org}/teams/{team}/members?role=member

Requisitos

NaturalezaReglaOpciones
Derechorequerido« Miembros : lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.

Datos conservados

CampoRolTipoObligatorio
MembershipKeyclave del objetotextosí
Idcontexto, sin efecto sobre la revisiónenterosí
TeamSlugcontexto, sin efecto sobre la revisióntextosí
TeamNamecontexto, sin efecto sobre la revisióntextono
Loginmostrado para reconocer el objetotextosí
Namemostrado para reconocer el objetotextono
Emailmostrado para reconocer el objetotextono
Rolecontexto, sin efecto sobre la revisióntextono
IsDirectcontexto, sin efecto sobre la revisiónbooleanono

17Equipos #sec_747f8015

github.teams.teams:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Equipos, su jerarquía y su visibilidad

Llamadas

  • GET /orgs/{org}/teams

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Miembros: lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los derechos deben constatarse con una llamada real.

Datos conservados

CampoRolTipoObligatorio
TeamIdclave del objetoenterosí
Namemostrado para reconocer el objetotextosí
Slugmostrado para reconocer el objetotextono
Descriptioncontexto, sin efecto sobre la revisióntextono
Privacyevaluado por las políticas REVIEWIT (visibilidad)textono
ParentTeamcontexto, sin efecto sobre la revisióntextono
Permissioncontexto, sin efecto sobre la revisióntextono
MemberCountcontexto, sin efecto sobre la revisiónenterono

18Aplicaciones de terceros · Instalaciones de aplicaciones GitHub #sec_a4f42618

github.apps.installations:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Aplicaciones instaladas, sus permisos y su alcance de repositorios

Llamadas

  • GET /orgs/{org}/installations

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Administración de organización: lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los derechos deben constatarse con una llamada real.

Datos conservados

CampoRolTipoObligatorio
InstallationIdclave del objetoenterosí
AppSlugmostrado para reconocer el objetotextosí
AppNamecontexto, sin efecto sobre la revisióntextono
TargetTypecontexto, sin efecto sobre la revisióntextono
TargetLogincontexto, sin efecto sobre la revisióntextono
RepositorySelectioncontexto, sin efecto sobre la revisióntextono
Permissionscontexto, sin efecto sobre la revisióntextono
CreatedAtcontexto, sin efecto sobre la revisiónfecha y horano

19Aplicaciones de terceros · Tokens de acceso personal #sec_b4797b61

github.apps.personal-access-tokens:collect · revisión 1 del contrato, publicada el 18 octubre 2026 · vía github.rest.reviewit.app-installation

Tokens de acceso personal de granularidad fina con acceso a la organización: portador, vencimiento, alcance, última utilización

Llamadas

  • GET /orgs/{org}/personal-access-tokens

Requisitos

NaturalezaReglaOpciones
Permisorequerido« Tokens de acceso personal de la organización: lectura »
Pertenenciarequeridoel identificador pertenece a la organización GitHub de la conexión

Condiciones de funcionamiento

  • se obtiene un token para el identificador
  • el servicio https://api.github.com responde

Frescura: comprobaciones de menos de 24 h; los derechos deben constatarse con una llamada real.

Datos conservados

CampoRolTipoObligatorio
TokenIdclave del objetoenterosí
Namemostrado para reconocer el objetotextosí
OwnerLogincontexto, sin efecto sobre la revisióntextono
TokenTypecontexto, sin efecto sobre la revisióntextono
Scopescontexto, sin efecto sobre la revisióntextono
RepositorySelectioncontexto, sin efecto sobre la revisióntextono
CreatedAtcontexto, sin efecto sobre la revisiónfecha y horano
ExpiresAtcontexto, sin efecto sobre la revisiónfecha y horano
LastUsedevaluado por las políticas REVIEWIT (fecha de última actividad)fecha y horano

20Para ir más allá #sec_889c6ab2

  • Comprender una conexión de recolección
  • Referencia de derechos por recurso
  • Leer un veredicto
Esc
↑↓ navegar↵ abrirVer todos los resultados →