Crear una GitHub App utilizando parámetros de URL

Puedes preseleccionar los ajustes de una nueva GitHub App utilizando [parámetros de consulta] de una URL (https://en.wikipedia.org/wiki/Query_string) para configurar rápidamente los nuevos ajustes de la GitHub App.

Acerca de los parámetros de URL de las GitHub App

Puedes agregar parámetros de consulta a estas URL para preseleccionar la configuración de una GitHub App en una cuenta organizacional o personal:

  • Cuenta de usuario: http(s)://[hostname]/settings/apps/new
  • Cuenta organizacional: http(s)://[hostname]/organizations/:org/settings/apps/new

El creador de la app puede editar los valores preseleccionados desde la página de registro de la GitHub App antes de emitirla. Si no incluyes los parámetros requeridos en la secuencia de consulta de la URL, como el name, el creador de la app necesitará ingresar un valor antes de emitirla.

La siguiente URL crea una app pública nueva que se llama octocat-github-app con una descripción preconfigurada y una URL de rellamado. Esta URL también selecciona los permisos de lectura y escritura para las checks, se suscribe a los eventos de webhook de check_run y check_suite, y selecciona la opción para solicitar la autorización del usuario (OAuth) durante la instalación:

http(s)://[hostname]/settings/apps/new?name=octocat-github-app&description=An%20Octocat%20App&callback_urls[]=https://example.com&request_oauth_on_install=true&public=true&checks=write&events[]=check_run&events[]=check_suite

La lista completa de parámetros de consulta, permisos y eventos disponibles se lista en las secciones siguientes.

Parámetros de configuración de una GitHub App

NombreTypeDescripción
name (nombre)secuenciaEl nombre de la GitHub App. Pónle un nombre claro y breve a tu app. Tu app no puede tener el mismo nombre que un usuario de GitHub, a menos de que sea tu propio nombre de usuario u organización. Una versión simplificada del nombre de tu aplicación se mostrará en la interface de usuario cuando tu integración tome alguna acción.
descripciónsecuenciaUna descripción de la GitHub App.
urlsecuenciaLa URL completa de tu página principal del sitio web de la GitHub App.
callback_urlsconjunto de secuenciasUna URL completa a la cual redirigir cuando alguien autorice una instalación. Puedes proporcionar hasta 10 URL de rellamado. Estas URL se utilizan si tu app necesita identificar y autorizar solicitudes de usuario a servidor. Por ejemplo, callback_urls[]=https://example.com&callback_urls[]=https://example-2.com.
request_oauth_on_installbooleanSi tu app autoriza a los usuarios mediante el flujo de OAuth, puedes configurar esta opción como true para permitir que las personas autoricen la app cuando la instalen, lo cual te ahorra un paso. Si seleccionas esta opción, la setup_url deja de estar disponible y se redirigirá a los usuarios a tu callback_url después de que instalen la app.
setup_urlsecuenciaLa URL completa a la cual se redirigirá después de que instalen la GitHub App si ésta requiere de alguna configuración adicional después de su instalación.
setup_on_updatebooleanConfigúralo como true para redireccionar a las personas a la URL de ajustes cuando las instalaciones se actualicen, por ejemplo, después de que se agreguen o eliminen repositorios.
publicbooleanConfigúralo como true cuando tu GitHub App se encuentre disponible al público, o como false cuando solo el propietario de la misma tenga acceso a ella.
webhook_urlsecuenciaLa URL completa a la cual quisieras enviar cargas útiles de eventos de webhook.
webhook_secretsecuenciaPuedes especificar un secreto para asegurar tus webhooks. Consulta la sección "Asegurar tus webhooks" para obtener más detalles.
eventsconjunto de secuenciasEventos de webhook. Algunos eventos de webhook requieren asignar permisos de read o de write a un recurso antes de que puedas seleccionar el evento cuando registras una GitHub App nueva. Consulta la sección "Eventos de webhook de las GitHub App" para encontrar los eventos disponibles y sus permisos requeridos. Puedes seleccionar eventos múltiples en una secuencia de consulta. Por ejemplo, events[]=public&events[]=label.
dominiosecuenciaLa URL de una referencia de contenido.
single_file_namesecuenciaEste es un permiso con alcance corto que permite a la app acceder a un solo archivo en cualquier repositorio. Cuando configuras el permiso de single_file en read o write, este campo proporciona la ruta al archivo único que administrará tu GitHub App. Si necesitas administrar varios archivos, consulta la opción single_file_paths a continuación.
single_file_pathsconjunto de secuenciasEsto permite a la app acceder hasta a 10 archivos especificos en un repositorio. Cuando configuras el permiso single_file en read o write, este arreglo puede almacenar las rutas de hasta diez archivos que administrará tu GitHub App. Estos archivos reciben el mismo permiso que se configuró para single_file, y no tienen permisos individuales por separado. Cuando dos o mas archivos se configuran, la API devuelve multiple_single_files=true, de lo contrario, devuelve multiple_single_files=false.

Permisos de la GitHub App

Puedes seleccionar los permisos en una secuencia de consulta utilizando los nombres de permiso conforme en la siguiente tabla a manera de nombres de parámetro de consulta y usando el tipo de permiso como el valor de la consulta. Por ejemplo, para seleccionar los permisos de Read & write en la interface de usuario para contents, tu secuencia de consulta incluiría &contents=write. Para seleccionar los permisos de Read-only en la interface de usuario para blocking, tu secuencia de consulta incluiría &blocking=read. Para seleccionar no-access en la interface de usuario para las checks, tu secuencia de consulta no incluiría el permiso checks.

PermisoDescripción
administrationOtorga acceso a diversas terminales para la administración de organizaciones y repositorios. Puede ser uno de entre none, read, o write.
verificacionesOtorga acceso a la API de verificaciones. Puede ser uno de entre none, read, o write.
content_referencesOtorga acceso a la terminal "Crear un adjunto de contenido". Puede ser uno de entre none, read, o write.
contenidosOtorga acceso a diversas terminales que te permiten modificar el contenido de los repositorios. Puede ser uno de entre none, read, o write.
implementacionesOtorga acceso a la API de despliegues. Puede ser uno de entre none, read, o write.
emailsOtorga acceso a la API de Correos electrónicos. Puede ser uno de entre none, read, o write.
followersOtorga acceso a la API de Seguidores. Puede ser uno de entre none, read, o write.
gpg_keysOtorga acceso a la API de Llaves GPG. Puede ser uno de entre none, read, o write.
propuestasOtorga acceso a la API de Informe de problemas. Puede ser uno de entre none, read, o write.
keysOtorga acceso a la API de Llaves Públicas. Puede ser uno de entre none, read, o write.
membersOtorga acceso para administrar los miembros de una organización. Puede ser uno de entre none, read, o write.
organization_hooksOtorga acceso a la API de Webhooks de la Organización. Puede ser uno de entre none, read, o write.
organization_planOtorga acceso para obtener información acerca del plan de una organización que utilice la terminal "Obtener una organización". Puede ser uno de entre none o read.
organization_projectsOtorga acceso a la API de Proyectos. Puede ser uno de entre: none, read, write, o admin.
páginasOtorga acceso a la API de páginas. Puede ser uno de entre none, read, o write.
planOtorga acceso para obtener información acerca del plan de GitHub de un usuario que utilice la terminal "Obtener un usuario". Puede ser uno de entre none o read.
pull_requestsOtorga acceso a varias terminales de solicitud de extracción. Puede ser uno de entre none, read, o write.
repository_hooksOtorga acceso a la API de Webhooks del Repositorio. Puede ser uno de entre none, read, o write.
repository_projectsOtorga acceso a la API de Proyectos. Puede ser uno de entre: none, read, write, o admin.
secret_scanning_alertsOtorga acceso a la API de escaneo de secretos. Puede ser uno de entre: none, read, o write.
security_eventsOtorga acceso a la API de escaneo de código. Puede ser uno de entre none, read, o write.
single_fileOtorga acceso a la API de Contenidos. Puede ser uno de entre none, read, o write.
starringOtorga acceso a la API de marcar con estrella. Puede ser uno de entre none, read, o write.
estadosOtorga acceso a la API de Estados. Puede ser uno de entre none, read, o write.
team_discussionsOtorga acceso a la API de debates de equipo y a la API de comentarios en debates de equipo. Puede ser uno de entre none, read, o write.
vulnerability_alertsOtorga acceso para recibir alertas de seguridad para las dependencias vulnerables en un repositorio. Consulta la sección "Acerca de las alertas para las dependencias vulnerables" para aprender más. Puede ser uno de entre: none o read.
observandoOtorga acceso a la lista y cambia los repositorios a los que un usuario está suscrito. Puede ser uno de entre none, read, o write.

Eventos de webhook de GitHub App

Nombre del evento de webhookPermiso requeridoDescripción
check_runverificacionesHa ocurrido una actividad de ejecución de verificación. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "ejecuciones de verificación".
check_suiteverificacionesHa ocurrido una actividad de suite de verificaciones. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "suites de verificaciones".
comentario_confirmación de cambioscontenidosSe creó un comentario de una confirmación. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "comentario de confirmación".
content_referencecontent_referencesUna referencia de contenido nueva se muestra como created. Se crea una referenci de contenido nueva cuando el cuerpo o el comentario de un informe de problemas o solicitud de extracción incluye un URL que empte con un dominio de referencia de contenido configurado. Para obtener más información, consulta la sección "Utilizar adjuntos de contenido" para aprender más sobre las referencias de contenido y sus adjuntos.
create (crear)contenidosSe crea una rama o etiqueta de Git. Para obtener más información, consulta la API de REST de "Datos de Git".
deletecontenidosSe borra una rama o etiqueta de Git. Para obtener más información, consulta la API de REST de "Datos de Git".
deploymentimplementacionesSe crea un despliegue. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "despliegue".
deployment_statusimplementacionesSe crea un despliegue. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "estados de despliegue".
bifurcacióncontenidosUn usuario bifurca un repositorio. Para obtener más información, consulta la API de REST de "bifurcaciones".
gollumcontenidosSe crea o actualiza una página de wiki. Para obtener más información, consulta la sección "Acerca de las wikis".
propuestaspropuestasLa actividar relacionada con un informe de problemas. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "informe de problemas".
comentario_propuestapropuestasActividad relacionada con un comentario a una propuesta o solicitud de cambios. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "comentrios del informe de problemas".
etiquetametadatosActividad relacionada con una etiqueta. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "etiquetas".
miembromembersLa actividad relacionada con los colaboradores del repositorio. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "colaboradores".
membershipmembersLa actividad relacionada con la membrecía del equipo. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "miembros del equipo".
hitosolicitud_extracciónLa actividar relacionada con los hitos. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "hitos".
organizationmembersLa actividad relacionada con una organización y sus miembros. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "organizaciones".
page_buildpáginasRepresenta un intento de compilación de un sitio de Páginas de GitHub, haya sido exitoso o no. Una subida a la rama habilitada de Páginas de GitHub (gh-pages para las páginas de proyecto, la rama predeterminada para las páginas de usuario y de organización) desencadena este evento.
projectrepository_projects u organization_projectsLa actividad relacionada con los tableros de proyecto. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "proyectos".
project_cardrepository_projects u organization_projectsLa actividad relacionada con las tarjetas de proyecto. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "tarjetas de proyecto".
project_columnrepository_projects u organization_projectsLa actividad relacionada con las columnas en un tablero de proyecto. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "columnas de proyecto".
publicmetadatosCuando un repositorio privado se hace público. Sin duda alguna: el mejor evento de GitHub Enterprise Server.
solicitud_extracciónpull_requestsLa actividad relacionada con las solicitudes de extracción. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "solicitudes de extracción".
revisión_solicitud de extracciónsolicitud_extracciónLa actividad relacionada con las revisiones de la solicitudes de extracción. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "revisiones de la solicitud de extracción".
comentarios _revisiones_solicitudes de extracciónsolicitud_extracciónLa actividar relacionada con los comentarios de revisión de la solicitud de extracción en el diff unificado de la misma. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "comentrios de revisión de la solicitud de extracción".
subircontenidosSe cargó una o más confirmaciones a la rama o etiqueta de un repositorio.
lanzamientocontenidosLa actividad relacionada con un lanzamiento. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "lanzamientos".
repositoriometadatosLa actividad relacionada con un repositorio. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "repositorios".
estadoestadosCuando el estado de una confirmación de Git cambia. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "estados".
equipomembersLa actividad relacionada con el equipo de una organización. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "equipos".
team_addmembersCuando se agrega un repositorio a un equipo.
observarmetadatosCuando alguien marca un repositorio con una estrella. El tipo de actividad se especifica en la propiedad action del objeto de la carga útil. Para obtener más información, consulta la API de REST de "marcar con una estrella".

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.