¿Qué es la API REST de Jira? Cómo aprovechar la API REST y proteger la clave API de Jira

Jira, la versátil plataforma de gestión de proyectos y seguimiento de incidencias de Atlassian, se ha convertido en una herramienta indispensable para innumerables equipos de desarrollo de todo el mundo. Si bien su interfaz fácil de usar facilita la gestión de proyectos y el seguimiento de incidencias, el verdadero poder de Jira reside en sus amplias opciones de personalización y capacidades de integración. En el centro de todo esto se encuentra la API REST de Jira, que abre un mundo de posibilidades para automatizar tareas, crear aplicaciones personalizadas e integrar Jira sin problemas con otras herramientas de su ecosistema de desarrollo. En esta guía completa, profundizaremos en la API REST de Jira, exploraremos sus capacidades y analizaremos ejemplos prácticos para ayudarlo a comenzar.

Puntos clave: La API REST de Jira es una herramienta versátil para automatizar tareas, crear aplicaciones personalizadas e integrar Jira con otras herramientas de desarrollo en las versiones de nube y de servidor/centro de datos. Ofrece una amplia gama de capacidades, que incluyen administración de problemas, operaciones masivas e informes personalizados, con soporte para funciones avanzadas como paginación y expansión de datos. Si bien existen algunas diferencias entre las versiones, la funcionalidad principal de la API sigue siendo la misma, lo que permite a los equipos personalizar Jira de manera eficiente según sus necesidades específicas e integrarlo sin problemas con su ecosistema de desarrollo.

¿Qué es la API de Jira?

En esencia, una API (interfaz de programación de aplicaciones) es un conjunto de protocolos y herramientas que especifican cómo deben interactuar los componentes de software. En el contexto de Jira, la API permite que las aplicaciones externas interactúen con Jira de manera programática, lo que permite la recuperación y manipulación de datos, así como la ejecución de acciones dentro de Jira. Jira ofrece dos tipos de API:

¿Qué es la API de Java?

La API de Jira Java es una herramienta poderosa para los desarrolladores que crean aplicaciones o complementos personalizados de Jira. Proporciona acceso directo a los objetos y métodos Java subyacentes del servidor Jira, lo que permite una integración y personalización profundas. Sin embargo, este nivel de acceso solo está disponible para instalaciones locales de Jira (servidor o centro de datos) donde tiene acceso directo al servidor. Si está trabajando con Jira Cloud o creando una integración independiente, la API REST es la mejor opción.

¿Qué es la API REST?

REST (Representational State Transfer) es un estilo arquitectónico que define un conjunto de restricciones para crear servicios web. Una API REST expone un conjunto de puntos finales HTTP a los que se puede acceder enviando solicitudes con métodos HTTP específicos (GET, POST, PUT, DELETE) para realizar operaciones en los recursos.

La API REST de Jira sigue esta arquitectura y ofrece un conjunto completo de puntos finales para interactuar con casi todos los aspectos de Jira, desde problemas y proyectos hasta paneles y tableros ágiles. Devuelve datos en formato JSON y admite una variedad de métodos de autenticación para garantizar un acceso seguro.

Una de las principales ventajas de la API REST es su independencia de la plataforma: se puede llamar a la API desde cualquier dispositivo o aplicación que pueda realizar solicitudes HTTP, independientemente del lenguaje de programación utilizado. Esto la convierte en la opción ideal para crear integraciones entre Jira y otras herramientas, o para crear secuencias de comandos de interacciones con Jira desde la línea de comandos.

¿Qué puedes hacer con la API REST de Jira?

Las posibilidades son casi infinitas. A continuación, se muestran algunos ejemplos de lo que puede lograr con la API REST de Jira:

• Automatizar la creación de problemas:Integre Jira con su sistema de seguimiento de errores o herramienta de atención al cliente para crear problemas automáticamente en Jira cuando ocurren ciertos eventos, junto con todos los detalles relevantes.
• Sincronizar datos entre sistemas: Mantenga Jira sincronizado con otras herramientas en su flujo de desarrollo, como sistemas de control de código fuente, herramientas de CI/CD o suites de gestión de pruebas. La API le permite reflejar los cambios en Jira en otros sistemas y viceversa.
• Operaciones masivas¿Necesita actualizar una gran cantidad de problemas a la vez? La API REST admite operaciones de creación, actualización y eliminación en masa, lo que le permite ahorrar incontables horas de trabajo manual.
• Paneles e informes personalizados:Recupere datos de Jira y úselos para crear paneles, informes o visualizaciones de datos personalizados adaptados a las necesidades específicas de su equipo.
• Amplíe la funcionalidad de Jira:Cree aplicaciones e integraciones personalizadas que amplíen las capacidades de Jira, agreguen nuevas funciones o agilicen los flujos de trabajo específicos de su organización.
• Migrar datos¿Está pasando de otro sistema de seguimiento de problemas a Jira? Utilice la API para importar programáticamente sus datos existentes a Jira.
• Copia de seguridad y archivo:Configure scripts para realizar copias de seguridad periódicas de sus datos de Jira o archivar proyectos y problemas antiguos.

Estos son solo algunos ejemplos: la API REST de Jira ofrece un amplio conjunto de puntos finales que cubren prácticamente todas las características y funciones disponibles en la interfaz de usuario de Jira. Si puede hacerlo en Jira, es probable que pueda hacerlo a través de la API.

Diferencias clave entre la API REST de Jira Cloud y la API REST de Data Center

Si bien la API REST de Jira proporciona en gran medida las mismas capacidades en Jira Cloud, Server y Data Center, hay algunas diferencias clave que se deben tener en cuenta:

• Autenticación:Jira Cloud utiliza OAuth 2.0 o tokens de API para la autenticación, lo que proporciona un método seguro y basado en estándares para otorgar acceso a la API. Jira Data Center, por otro lado, utiliza principalmente autenticación básica o cookies de sesión.
• Control de versiones de API:La API REST de Jira Cloud tiene versiones (actualmente en la versión 3), lo que permite que Atlassian evolucione y mejore la API con el tiempo sin interrumpir las integraciones existentes. Sin embargo, Jira Data Center no tiene versiones explícitas: la API está vinculada a la versión específica de Jira.
• Limitación de la velocidad:Para garantizar un uso justo y mantener el rendimiento, Jira Cloud aplica límites de velocidad más estrictos a las solicitudes de API en comparación con Data Center. Las integraciones deben diseñarse teniendo en cuenta estos límites e implementar una limitación y un manejo de errores adecuados.
• Formato de URL:Las URL de los puntos finales para la API REST difieren levemente entre la nube y el centro de datos. Para Jira Cloud, la URL base tiene el formato https://your-domain.atlassian.net/rest/api/3/, mientras que para el centro de datos es https://your-jira-instance.com/rest/api/latest/.

A pesar de estas diferencias, los conceptos básicos y los patrones de uso de la API REST siguen siendo en gran medida los mismos en todas las implementaciones. Las habilidades y los conocimientos que adquiera al trabajar con una versión de la API se podrán transferir fácilmente a otras.

¿Qué necesitas para trabajar con Jira REST API?

Para comenzar a utilizar la API REST de Jira, necesitará:

• Una instancia de Jira:Puede ser un sitio de Jira Cloud o una instancia de Jira Server o Data Center alojada por usted mismo. Necesitará acceso de administrador para configurar y administrar sus integraciones de API.
• Credenciales de autenticación:Dependiendo de su implementación de Jira, esto podría ser un token OAuth 2.0, un token API o credenciales de autenticación básicas (nombre de usuario y contraseña).
• Cliente API:Para realizar solicitudes HTTP a la API, necesitará un cliente de API. Puede ser una herramienta de prueba de API dedicada como Postman, una herramienta de línea de comandos como cURL o la biblioteca HTTP en el lenguaje de programación que elija (por ejemplo, la biblioteca de solicitudes de Python o la API de búsqueda de JavaScript).
• Referencia de la documentación de la API de JiraAtlassian ofrece documentación extensa para la API REST de Jira, en la que se detallan cada punto de conexión, sus parámetros y solicitudes y respuestas de ejemplo. Tenla a mano mientras exploras la API.

Con estos elementos en su lugar, está listo para comenzar a realizar sus primeras solicitudes de API.

Cómo utilizar la API REST de Jira 

Veamos un ejemplo práctico del uso de la API REST de Jira para crear, recuperar, actualizar y buscar problemas. Usaremos Postman para nuestros ejemplos, pero los principios se aplican a cualquier cliente de API.

Paso 1: Crear una cuenta de Jira Cloud

Si aún no tiene una instancia de Jira con la que trabajar, la forma más fácil de comenzar es registrarse para obtener una instancia gratuita de Jira Cloud en https://www.atlassian.com/software/jiraUna vez que su sitio esté configurado, cree un nuevo proyecto con el que trabajar.

Paso 2: Generar un token de API de Jira

Para autenticar nuestras solicitudes de API, utilizaremos un token de API. A continuación, se explica cómo generar uno:

1. Inicie sesión en su cuenta de Atlassian y navegue hasta https://id.atlassian.com/manage-profile/security/api-tokens.
2. Haga clic en "Crear token de API", asigne a su token una etiqueta descriptiva y haga clic en "Crear".

1. Copia el token generado y guárdalo de forma segura. No podrás volver a verlo después de salir de esta página.

Paso 3: Realiza tu primera solicitud de API con Postman

Comencemos recuperando los detalles de un problema existente:

1. Abra Postman y cree una nueva solicitud.
2. Establezca el método HTTP en GET e ingrese la URL para el punto final de detalles del problema, reemplazando your-domain con el dominio de su sitio Jira y ISSUE-KEY con la clave de un problema en su proyecto: https://your-domain.atlassian.net/rest/api/3/issue/ISSUE-KEY
3. En la pestaña "Autorización", seleccione "Autenticación básica" como tipo. Ingrese la dirección de correo electrónico de su cuenta de Atlassian como nombre de usuario y pegue su token de API como contraseña.
4. Haz clic en "Enviar". Si todo está configurado correctamente, deberías ver una respuesta en formato JSON con todos los detalles del problema especificado, incluidos sus campos, comentarios, archivos adjuntos y más.

Paso 4: Crear un problema

Ahora vamos a crear un nuevo problema a través de la API:

1. En Postman, cambie el método HTTP a POST y actualice la URL al punto final de creación del problema: https://your-domain.atlassian.net/rest/api/3/issue
2. En la pestaña "Encabezados", agrega un nuevo par clave-valor: "Content-Type" y "application/json". Esto le indica a Jira que estamos enviando una carga útil JSON.

Cambie a la pestaña "Cuerpo", seleccione el botón de opción "sin procesar" e ingrese el siguiente JSON, reemplazando los valores de project.key, issuetype.name, summary y description según corresponda:

 json

{
  "fields": {
    "project": {
      "key": "YOUR_PROJECT_KEY"
    },
    "issuetype": {
       "name": "Task"
    },
    "summary": "Issue created via REST API",
    "description": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "This is a test issue created using the Jira REST API."
            }
          ]
        }
      ]
    }
  }
}

3. Haga clic en "Enviar". Jira responderá con el estado "201 Creado" y los detalles completos del problema recién creado.

Paso 5: Actualizar un problema

Para actualizar un problema existente, utilizamos el método PUT:

1. Cambie el método HTTP a PUT y actualice la URL para apuntar al problema que desea actualizar: https://your-domain.atlassian.net/rest/api/3/issue/ISSUE-KEY

En el cuerpo de la solicitud, incluya los campos que desea actualizar, por ejemplo:

 json

{
  "fields": {
    "summary": "Updated summary",
    "description": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "This issue has been updated via the REST API."
            }
          ]
        }
      ]
    }
  }
}

2. Haga clic en "Enviar". Jira responderá con el estado 204 Sin contenido para indicar que la actualización se realizó correctamente.

Paso 6: Busque problemas usando JQL

Las potentes capacidades de búsqueda de Jira también son accesibles a través de la API REST usando JQL (Jira Query Language):

1. Cambie el método HTTP nuevamente a POST y actualice la URL al punto final de búsqueda: https://your-domain.atlassian.net/rest/api/3/search

En el cuerpo de la solicitud, incluya una consulta JQL y cualquier parámetro adicional:

 json
Copy
{
  "jql": "project = YOUR_PROJECT_KEY AND status = 'To Do' ORDER BY created DESC",
  "fields": ["summary", "status", "assignee"],
  "maxResults": 10
}

 Esta consulta devolverá los 10 problemas creados más recientemente en el estado "Por hacer" del proyecto especificado, incluidos solo los campos de resumen, estado y asignado.

2. Haga clic en "Enviar". Jira le responderá con una matriz JSON de problemas que coinciden con sus criterios de búsqueda.

Estos ejemplos son solo una pequeña muestra de lo que es posible con la API REST de Jira. A medida que se familiarice con los puntos de conexión y los parámetros disponibles, podrá crear integraciones cada vez más complejas y potentes.

Cómo automatizar la creación y actualización de problemas en Jira con Latenode

Una de las aplicaciones más potentes de la API REST de Jira es la automatización de la creación y actualización de tareas. Con Latenode, puede configurar flujos de trabajo sofisticados que crean y actualizan automáticamente tareas en Jira en función de datos de fuentes externas o activadores específicos. Esto garantiza que la información en su sistema de gestión de proyectos se mantenga actualizada y oportuna, lo que mejora la eficiencia del equipo.

Por ejemplo, podría crear un flujo de trabajo que cree automáticamente una nueva tarea en Jira cuando se reciba un mensaje de error de un sistema de monitoreo, que complete todos los campos necesarios y asigne la tarea al desarrollador correspondiente. A medida que se reciban actualizaciones, la tarea se puede actualizar automáticamente y, cuando se resuelva el problema, se puede cerrar. Este enfoque simplificado no solo mejora el seguimiento de los problemas, sino que también le ahorra tiempo a su equipo, lo que le permite centrarse en resolverlos en lugar de administrarlos.

Puede obtener más información sobre este script y la integración con Latenode en este artículo. La integración con Latenode ofrece algunos beneficios clave:

• Facilidad de Uso Latenode simplifica el proceso de uso de la API de Jira, lo que facilita que los usuarios no técnicos automaticen las tareas de gestión de proyectos.
• Precios flexibles Los usuarios pueden elegir entre diferentes planes de Latenode, con diferentes costos y características, para adaptarse mejor a sus necesidades.
• Soluciones integrales La integración de Latenode con Jira proporciona acceso a una amplia gama de capacidades de gestión de proyectos y seguimiento de problemas.
• Personalización Los usuarios pueden adaptar las integraciones de Jira para satisfacer sus necesidades específicas, lo que permite soluciones de automatización personalizadas y alineadas con los objetivos comerciales.

Imagine que cada correo electrónico importante de un cliente se convierte automáticamente en una tarea en Jira. Con Latenode, esto se convierte en realidad. Nuestra plataforma garantiza la creación de una nueva tarea en el proyecto correcto con campos rellenados en función del contenido del correo electrónico, lo que garantiza que no se pase por alto ninguna solicitud importante.

A continuación se muestra un ejemplo de cómo un flujo de trabajo de Latenode automatiza la creación y las actualizaciones de tareas de Jira en función de los datos de correo electrónico entrantes de una fuente externa.

Esta imagen mostraría una representación visual del flujo de trabajo en la interfaz de Latenode, con nodos conectados que representan cada paso del proceso desde la recepción del correo electrónico hasta la creación de tareas de Jira.

Este es solo un ejemplo de cómo Latenode puede transformar su enfoque en el uso de la API de Jira con una potente automatización. De hecho, las capacidades de la plataforma son prácticamente ilimitadas: puede crear cualquier escenario de automatización necesario para mejorar la eficiencia de su negocio. Ya sea la distribución automática de tareas, el envío de notificaciones, el seguimiento de indicadores clave de rendimiento o cualquier otra tarea, Latenode proporciona las herramientas para darles vida.

Al aprovechar el generador de flujo de trabajo visual de Latenode y la integración perfecta con la API REST de Jira, puede diseñar e implementar fácilmente escenarios de automatización complejos, aumentando la eficiencia de la gestión de proyectos y acelerando los flujos de trabajo de su equipo.

Si necesitas ayuda o asesoramiento sobre cómo crear tu propio script o si quieres replicar éste, contacta con nuestra comunidad de discordia, donde se encuentran los expertos en automatización Low-code.

Paginación, expansión y ordenación de la API REST de Jira

A medida que comience a trabajar con conjuntos de datos más grandes en Jira, deberá tener en cuenta cómo la API REST maneja la paginación, la expansión de recursos anidados y el orden de los resultados.

Expansión

Muchos recursos de Jira contienen referencias a otros recursos anidados. Por ejemplo, un Issue contiene referencias a su Proyecto, Tipo de Issue, Creador, Reportero, Asignado, Comentarios, Archivos adjuntos y más. De manera predeterminada, estos recursos anidados se devuelven como stubs, que contienen solo algunos campos básicos y un vínculo propio al recurso completo.

Si necesita los detalles completos de un recurso anidado, puede usar el parámetro de consulta expand para solicitar que Jira incluya el recurso completo en la respuesta. Por ejemplo, para incluir los detalles completos del proyecto y el asignado de un problema:

GET .../rest/api/3/issue/ISSUE-KEY?expand=project,assignee

Puedes ampliar varios recursos separándolos con comas. Ten en cuenta que las ampliaciones pueden aumentar significativamente el tamaño de la carga útil de la respuesta, por lo que debes utilizarlas con prudencia.

Paginación

Las solicitudes que podrían devolver una gran cantidad de resultados (como las búsquedas JQL) se paginan de forma predeterminada. La API devolverá una cantidad máxima de resultados por página (el valor predeterminado es 50, pero se puede personalizar hasta 100) junto con enlaces a las páginas anterior y siguiente.

Puede controlar la paginación utilizando los parámetros startAt y maxResults:

• startAt: El índice del primer resultado a devolver (basado en 0)
• maxResults: El número máximo de resultados a devolver por página

Por ejemplo, para recuperar la segunda página de resultados con un tamaño de página de 20:

GET .../rest/api/3/search?jql=project=YOUR_PROJECT_KEY&startAt=20&maxResults=20

Su aplicación deberá realizar múltiples solicitudes para recuperar todas las páginas de resultados.

Órdenes

Puede controlar el orden de los resultados mediante el parámetro orderBy, que acepta una lista de campos separados por comas para ordenarlos. Cada campo puede tener como prefijo - para indicar orden descendente.

Por ejemplo, para ordenar los problemas por fecha de creación de manera descendente y luego por prioridad de manera ascendente:

OBTENER .../rest/api/3/search?jql=proyecto=SU_CLAVE_DE_PROYECTO&orderBy=-created,prioridad

No todos los campos admiten el pedido: consulte la documentación del punto final específico para ver qué está disponible.

Ejemplos de uso de la API de Jira

A continuación se muestran un par de ejemplos más avanzados que demuestran el poder de la API REST de Jira para operaciones masivas.

Creación/actualización masiva de problemas desde CSV

Supongamos que tiene un archivo CSV que contiene datos de varios problemas que desea crear o actualizar en Jira. Puede utilizar una herramienta como Postman para automatizar este proceso:

1. En Postman, cree una nueva solicitud para el punto final de creación o actualización del problema.

En la pestaña Cuerpo, seleccione el botón de opción "sin procesar" e ingrese una plantilla para los datos de su problema, utilizando variables para los campos que provendrán de su CSV:

{
  "fields": {
    "project": {"key": "{{project_key}}"},
    "issuetype": {"name": "{{issue_type}}"},
    "summary": "{{summary}}",
    "description": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "{{description}}"
            }
          ]
        }
      ]
    },
    "assignee": {"name": "{{assignee}}"},
    "priority": {"name": "{{priority}}"}
  }
}

2. Cambie a la pestaña "Script de solicitud previa" y agregue código para leer su archivo CSV y configurar las variables correspondientes:

const csvFile = pm.iterationData.readCSV();
pm.variables.set('project_key', csvFile[0]);
pm.variables.set('issue_type', csvFile[1]);
pm.variables.set('summary', csvFile[2]);
pm.variables.set('description', csvFile[3]);
pm.variables.set('assignee', csvFile[4]);
pm.variables.set('priority', csvFile[5]);

3. En la ventana "Ejecutor", seleccione su archivo CSV como archivo de datos e inicie la ejecución. Postman creará una nueva solicitud para cada fila de su CSV, sustituyendo las variables del archivo.

Esta es una técnica poderosa para importar datos en masa a Jira desde fuentes externas.

Creación/actualización masiva de problemas desde JSON

Si sus datos de origen ya están en formato JSON, puede utilizar el punto final de creación/actualización masiva para procesar varios problemas en una sola solicitud:

PUBLICACIÓN https://su-dominio.atlassian.net/rest/api/3/issue/bulk

El cuerpo de la solicitud debe contener una matriz de objetos de creación/actualización de problemas, cada uno siguiendo el mismo formato que una única solicitud de creación/actualización de problemas:

{
  "issueUpdates": [
    {
      "fields": {
        "project": {"key": "PROJ1"},
        "issuetype": {"name": "Task"},
        "summary": "Issue 1",
        "description": {
          "type": "doc",
          "version": 1,
          "content": [
            {
              "type": "paragraph",
              "content": [
                {
                  "type": "text",
                  "text": "First issue created via bulk update"
                }
              ]
            }
          ]
        }
      }
    },
    {
      "fields": {
        "project": {"key": "PROJ2"},
        "issuetype": {"name": "Bug"},
        "summary": "Issue 2",
        "description": {
          "type": "doc",
          "version": 1,
          "content": [
            {
              "type": "paragraph",
              "content": [
                {
                  "type": "text",
                  "text": "Second issue created via bulk update"
                }
              ]
            }
          ]
        },
        "priority": {"name": "High"},
        "labels": ["bulk-import", "api-test"]
      }
    }
  ]
}

Esto creará dos problemas en una sola solicitud: una tarea en el proyecto PROJ1 y un error en el proyecto PROJ2. Puede incluir hasta 50 problemas en una única solicitud masiva.

El punto final masivo también es útil para realizar transiciones, actualizaciones y eliminaciones masivas. Por ejemplo, para realizar la transición de varios problemas al estado "Listo":

{
  "transition": {
    "id": "31"
  },
  "issues": [
    {"key": "ISSUE-1"},
    {"key": "ISSUE-2"},
    {"key": "ISSUE-3"}
  ]
}

Esto supone que "31" es el ID de su transición "Listo"; puede encontrar las transiciones disponibles para un tipo de problema a través del punto final /rest/api/3/issue/{issueIdOrKey}/transitions.

Resum

La API REST de Jira es una herramienta sumamente poderosa para integrar Jira con otros sistemas, automatizar tareas y ampliar las capacidades de Jira. En esta guía, cubrimos los aspectos básicos de la API, incluidos:

• La diferencia entre las API de Java y REST, y cuándo utilizar cada una
• Diferencias clave entre las API de la nube y del servidor/centro de datos
• Cómo autenticarse en la API mediante tokens API o autenticación básica
• Cómo realizar sus primeras solicitudes de API con Postman
• Creación, recuperación, actualización y búsqueda de problemas
• Manejo de paginación, expansión y ordenación de resultados
• Casos de uso avanzados como creación/actualización masiva de datos CSV y JSON

Sin embargo, esto es solo el comienzo. La API REST de Jira proporciona puntos de conexión para trabajar con casi todos los aspectos de Jira, desde proyectos y tableros hasta usuarios y permisos. A medida que crea sus integraciones, asegúrese de consultar la documentación oficial de Atlassian para obtener la información más actualizada y completa.

Con la API REST de Jira en su conjunto de herramientas, las posibilidades de lo que puede hacer con Jira son casi infinitas. Ya sea que esté creando un panel de informes personalizado, sincronizando datos con otro sistema o automatizando flujos de trabajo complejos, la API le brinda la flexibilidad y la potencia que necesita para lograrlo.

Preguntas Frecuentes

¿Qué métodos de autenticación admite la API REST de Jira?

Jira Cloud es compatible con OAuth 2.0 y tokens API para la autenticación. Para OAuth, deberá registrar su aplicación en la consola para desarrolladores de Atlassian para obtener un ID de cliente y un secreto. Los tokens API son una opción más sencilla para scripts e integraciones personales. Jira Server y Data Center son compatibles con la autenticación básica (nombre de usuario y contraseña) y la autenticación basada en sesiones mediante cookies.

¿La API REST de Jira es diferente entre Jira Cloud y Jira Data Center?

Si bien los puntos finales y las funcionalidades principales son en gran medida los mismos, existen algunas diferencias clave:

• La URL base de la API es diferente: Cloud usa https://your-domain.atlassian.net/rest/api/3/, mientras que Server/Data Center usa https://your-jira-instance.com/rest/api/latest/.
• La nube aplica límites de velocidad más estrictos y requiere autenticación para todas las solicitudes, mientras que el servidor/centro de datos tiene valores predeterminados más flexibles.
• Algunas funciones avanzadas, como las API de Agile y Service Desk, tienen diferencias en los puntos finales disponibles y los formatos de solicitud/respuesta entre la nube y el servidor/centro de datos.

Consulte siempre la documentación específica de su implementación de Jira para asegurarse de utilizar las URL y los parámetros correctos.

¿Cómo gestionar la limitación de velocidad de la API?

Jira Cloud aplica límites de velocidad para garantizar la estabilidad y el rendimiento del servicio. Si supera el límite de velocidad, recibirá una respuesta 429 Demasiadas solicitudes.

Para evitar alcanzar los límites de velocidad:

• Almacene datos en caché siempre que sea posible para evitar realizar solicitudes repetitivas.
• Utilice la paginación para recuperar grandes conjuntos de resultados en múltiples solicitudes en lugar de intentar recuperar todo a la vez.
• Implemente un retroceso exponencial en su código de cliente para aumentar progresivamente la demora entre reintentos cuando se encuentra un límite de velocidad.
• Si tiene una necesidad legítima de un límite de velocidad más alto, comuníquese con el soporte de Atlassian para analizar sus opciones.

Las implementaciones de servidores y centros de datos tienen la limitación de velocidad deshabilitada de manera predeterminada, pero los administradores pueden elegir habilitar y configurar límites de velocidad si es necesario.

¿Puedo utilizar la API REST de Jira para servidor/centro de datos?

Sí, Jira Server y Data Center tienen una API REST que es muy similar a la API de Jira Cloud. Las principales diferencias son:

• La URL base utiliza /rest/api/latest/ en lugar de /rest/api/3/.
• Algunos puntos finales pueden tener parámetros o formatos de respuesta ligeramente diferentes.
• La autenticación generalmente se realiza mediante autenticación básica o cookies de sesión en lugar de OAuth o tokens API.

Consulta la documentación de la API de descanso específica del servidor/centro de datos para obtener la información más precisa para tu versión de Jira.

La API REST de Jira es una forma potente y flexible de integrar Jira en su flujo de trabajo de desarrollo. Ya sea que trabaje en la nube o administre su propio servidor, la API proporciona las herramientas que necesita para automatizar, personalizar y ampliar Jira para que se ajuste a las necesidades únicas de su equipo. Con un poco de exploración y experimentación, podrá aprovechar todo el potencial de Jira y llevar la gestión de proyectos al siguiente nivel.