Tools de GitHub
Las 12 operaciones de GitHub que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Listar repositoriosGETLista los repositorios a los que llega la cuenta: los propios, aquellos donde es colaboradora y los de sus organizaciones. Cada elemento tiene owner.login y name, que son el owner y el repo que piden las demás herramientas. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Buscar issuesGETBusca issues y pull requests en todos los repositorios que ve la cuenta, con la sintaxis de búsqueda de GitHub en q. Devuelve total_count e items, hasta 1.000 resultados por búsqueda; pagina con page y per_page. Cada elemento tiene number, y repository_url termina con el owner y el repo del elemento.
- Listar issuesGETLista las issues de un repositorio, de la más nueva a la más antigua. Los pull requests también vienen en la lista, marcados con la clave pull_request. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Obtener issueGETDevuelve una issue, con title, body, state, labels, assignees y milestone. Una issue movida a otro repositorio responde 301 con su nueva ubicación.
- Crear issuePOSTCrea una issue en un repositorio y la devuelve, con su number. Labels, assignees, milestone y type se descartan en silencio cuando la cuenta no tiene acceso de push al repositorio. Notifica a quienes siguen el repositorio.
- Actualizar issuePATCHModifica una issue y la devuelve. Solo cambian los campos enviados. Para cerrarla, envía state closed con un state_reason. Labels y assignees reemplazan los actuales, y una lista vacía los borra.
- Listar comentarios de la issueGETLista los comentarios de una issue o de un pull request, del más antiguo al más nuevo. Los comentarios de revisión sobre el código de un pull request no están incluidos. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Crear comentario en la issuePOSTAgrega un comentario a una issue o a un pull request y lo devuelve. Notifica a los participantes.
- Listar pull requestsGETLista los pull requests de un repositorio, del más nuevo al más antiguo. Pagina con page y per_page: una página con menos elementos que per_page es la última.
- Obtener pull requestGETDevuelve un pull request, con sus ramas, head.sha, mergeable y mergeable_state, el número de commits y de archivos cambiados y si ya fue fusionado. mergeable puede venir null mientras GitHub lo calcula: llama de nuevo tras unos segundos.
- Crear pull requestPOSTAbre un pull request desde la rama head hacia la rama base y lo devuelve, con su number. Envía title, o issue para convertir una issue existente en pull request. Notifica a quienes siguen el repositorio.
- Fusionar pull requestPUTFusiona un pull request en su rama base y devuelve merged y el sha del nuevo commit. Responde 405 cuando el pull request no se puede fusionar, y 409 cuando el sha ya no coincide con su head. Los repositorios que fusionan con merge queue no lo aceptan.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
