Saltar al contenido principal

¿Cómo acceder a Azure DevOps vía API Rest?

· 4 min de lectura
Héctor Mansilla Arias

Azure DevOps es una plataforma de servicios en la nube proporcionada por Microsoft que se utiliza para el desarrollo de software y la entrega continua. Ofrece una variedad de herramientas y servicios que ayudan a los equipos de desarrollo de software a planificar, desarrollar, probar y entregar aplicaciones de manera eficiente.

Las principales características y componentes de Azure DevOps incluyen:

Azure Boards: Esto permite la planificación de proyectos, la gestión de tareas y la colaboración en equipos ágiles. Puedes utilizar tableros Kanban y herramientas de seguimiento de problemas para administrar tu trabajo.

Azure Repos: Proporciona un sistema de control de versiones basado en Git para el seguimiento de cambios en el código fuente y la colaboración entre desarrolladores.

Azure Pipelines: Esta característica permite automatizar la compilación, las pruebas y la implementación de aplicaciones en diversos entornos. Puedes crear flujos de trabajo de entrega continua (CI/CD) para automatizar todo el proceso de desarrollo y entrega de software.

Azure Test Plans: Facilita la planificación, el seguimiento y la administración de pruebas de software, lo que ayuda a garantizar la calidad del software antes de su implementación.

Azure Artifacts: Proporciona un sistema de gestión de paquetes para almacenar y compartir artefactos de software como bibliotecas, paquetes NuGet y contenedores de Docker.

Azure DevTest Labs: Permite crear entornos de desarrollo y pruebas bajo demanda para equipos de desarrollo y pruebas.

Azure Monitor y Azure Application Insights: Ofrecen capacidades de supervisión y análisis para aplicaciones en producción, lo que permite identificar problemas y mejorar el rendimiento de las aplicaciones en tiempo real.

Azure DevOps es utilizado por equipos de desarrollo en una amplia variedad de industrias y tamaños de empresas para agilizar el ciclo de vida de desarrollo de software, mejorar la colaboración entre equipos y asegurarse de que las aplicaciones se entreguen de manera confiable y de alta calidad.

Hay veces en que necesitamos hacer integración de este tipo de servicios cloud con nuestras aplicaciones, por ejemplo, en JS. Es por ello que al revisar la documentación, algunos tutoriales disponibles y uno que otro video en youtube, podrías terminar igual o peor que al principio.

A continuación, te proporcionaré una guía básica de los pasos que debes seguir para conectarte y realizar solicitudes a la API de Azure DevOps:

Configura una cuenta de Azure DevOps: Si aún no tienes una, debes registrarte en Azure DevOps y configurar tu organización y proyecto.

Genera un token de acceso personal: Para autenticarte en la API de Azure DevOps, necesitas un token de acceso personal. Puedes crear uno siguiendo estos pasos:

  1. Inicia sesión en Azure DevOps. Imagen referencial de Azure Devops.

  2. Haz clic en el ícono de persona con un engranaje y selecciona "Personal Access Token". Imagen referencial de la instrucción: Haz clic en el ícono de persona con un engranaje y selecciona "Personal Access Token".

  3. En la sección "Personal Access Token", crea un nuevo token. Proporciona un nombre descriptivo y selecciona los alcances (scopes) necesarios para las operaciones que planeas realizar a través de la API.

  4. Copia el token generado y guárdalo en un lugar seguro. Este token es confidencial y solo se muestra una vez.

Ahora viene el trucazo... para hacer la llamada a la API, se debe definir las credenciales de la siguiente manera y codificado en base64:

username:PersonalAccessToken

Para codificar tus datos, Haz click aquí, luego, en tu cliente favorito como Postman o Insomnia puede usar la siguiente forma de autentificación:

Authorization: basic eW9AbWltYWlsLmNvbTpNaVBlcnNvbmFsQWNjZXNzVG9rZW4=

El ejemplo corresponde a los siguientes datos de ejemplo: yo@mimail.com:MiPersonalAccessToken

Realiza solicitudes a la API: Puedes hacer una prueba para ingresar una tarjeta de prueba con la siguiente configuración, válida para tu cliente favorito.

URL: https://dev.azure.com/{MiOrganizacion}/{MiProyecto}/_apis/wit/workitems/$User%20Story?api-version=7.0

Content-Type: application/json-patch+json

Authorization: basic {Tu user:PersonalAccessTokenCodificadoEnBase64}

body:

[
{
"op": "add",
"path": "/fields/System.Title",
"from": null,
"value": "Título de Ejemplo"
}
]

Para más información respecto a la API de Azure DevOps, favor consultar su documentación acá.