Saltar a contenido

Vista general de la API de ITM Platform

La API de ITM Platform le permite integrar ITM Platform con sus aplicaciones existentes, sincronizando datos y ampliando la funcionalidad. Usted puede utilizarla para conectar con sistemas como ERP y herramientas ITSM, automatizar procesos y crear reportes personalizados.

Puede encontrar la documentación de la API en ITM Platform Developers.

La API ofrece una amplia gama de funcionalidades para interactuar de forma programática con ITM Platform. A continuación, se presentan algunas capacidades clave:

  • Recuperación y Gestión de Datos: Acceda y gestione proyectos, tareas, recursos y otras entidades dentro de ITM Platform.
  • Integración con Sistemas Externos: Sincronice datos entre ITM Platform y aplicaciones externas, como sistemas ERP, asegurando la consistencia en todas las plataformas.
  • Automatización de Procesos: Automatice tareas rutinarias mediante la creación de scripts que interactúan con ITM Platform, reduciendo el esfuerzo manual.
  • Reportes Personalizados y Análisis: Extraiga datos para analizarlos en herramientas como Power BI, permitiéndole la generación de reportes personalizados y la obtención de información relevante.

Ejemplos:

  • Integración con ERP: Actualice automáticamente los presupuestos de proyecto en ITM Platform cuando se produzcan cambios en su sistema ERP, asegurando que los datos financieros se mantengan consistentes.
  • Integración con ITSM: Cree tareas en ITM Platform basándose en tickets generados en su herramienta ITSM, optimizando el seguimiento y la resolución de incidencias.

Utilizando la API de ITM Platform

Existen varios enfoques para interactuar con la API de ITM Platform:

1. Utilizando un Lenguaje de Programación y Servidor

Los desarrolladores pueden escribir scripts en lenguajes como Python, JavaScript o Java para realizar peticiones HTTP a la API. Estos scripts pueden alojarse en servidores o en plataformas en la nube para ejecutarse como tareas programadas o en respuesta a eventos específicos.

Ejemplo en JS/Node:

const apiKey = 'your_api_key';
const url = 'https://api.itmplatform.com/v2/projects/search';

const requestData = {
  columns: { "$in": ["Id", "Name"] },
  filter: { "Name": { "$regex": "ACME|Project|Implementation" } }, 
  pageSize: 30,
  sortBy: "Name",
  sortOrder: "desc"
};

fetch(url, {
  method: 'POST',
  headers: {
    'token': apiKey, 
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(requestData)
})
.then(response => response.json())
.then(data => console.log('Retrieved projects:', data));

2. Utilizando Herramientas de Automatización de Terceros

Plataformas como Zapier, Make o Power Automate le permiten crear flujos de trabajo automatizados (a menudo denominados "Zaps", "Escenarios" o "Flujos") que conectan ITM Platform con otras aplicaciones sin necesidad de programar extensamente.

Ejemplo de flujo de trabajo:

  • Disparador: Se añade una nueva fila en una hoja de cálculo de Google Sheets.
  • Acción: Crear una nueva tarea en ITM Platform con los detalles de la fila de la hoja de cálculo.

3. Integración con Herramientas de Análisis

Para llevar a cabo análisis de datos avanzados, puede conectar ITM Platform con herramientas analíticas como Microsoft Power BI (consulte ejemplos en nuestras Plantillas de Power BI). Esto le permite visualizar datos y crear reportes personalizados.

Pasos:

  1. Extracción de Datos: Utilice la API para obtener datos de ITM Platform.
  2. Transformación de Datos: Formatee los datos según sea necesario para el análisis.
  3. Carga de Datos: Importe los datos en Power BI para crear cuadros de mando y reportes.

4. Aprovechando las Extensiones de ITM Platform

ITM Platform soporta extensiones personalizables, que son scripts que añaden funcionalidades específicas o conectan ITM Platform con sistemas de terceros. Estas extensiones se definen utilizando JSON y pueden gestionarse directamente desde la interfaz de ITM Platform.

Ejemplo:

Crear una extensión que envíe una notificación por correo electrónico cada vez que se actualice el estado de un proyecto.

Estructura del script de extensión:

{
  "name": "hubspot-sync",
  "details": {
    "title": { "en": "Sincronización de HubSpot con ITM Platform" },
    "version": "1.0",
    "developer": "ITM Platform"
  },
  "features": [
    {
      "trigger": "scheduler",
      "description": "Sincronizar empresas de HubSpot a ITM Platform",
      "actions": [
        {
          "action": "restcall",
          "url": "https://api.hubapi.com/crm/v3/objects/companies/search/?hapikey={{ config.apikeyHubspot }}",
          "method": "POST",
          "output": "companiesHS",
          "payload": "{\"properties\": [\"name\"], \"filterGroups\": [{\"filters\": [{\"propertyName\": \"sync_itm_platform\", \"operator\": \"EQ\", \"value\": \"true\"}]}]}",
          "dataType": "application/json"
        },
        {
          "action": "loop",
          "loop": { "var": "companiesHS.results", "output": "company" },
          "actions": [
            {
              "action": "restcall",
              "url": "@@ITMAPI@@/v2/@@AccountName@@/clients/",
              "method": "POST",
              "payload": "{\"Name\": \"{{ company.properties.name }}\"}",
              "dataType": "application/json"
            }
          ]
        }
      ]
    }
  ],
  "config": [
    { "name": "apikeyHubspot", "label": { "en": "Clave API de HubSpot" }, "type": "string", "required": true }
  ]
}

Esta extensión obtiene empresas desde HubSpot que están marcadas para sincronización y las crea como clientes en ITM Platform. Se ejecuta mediante un disparador programado, llamando a la API de HubSpot, iterando a través de los resultados y enviando nuevos clientes a ITM Platform.

Para obtener información más detallada y ejemplos adicionales, consulte la Documentación de la API de ITM Platform y la Documentación para la Creación de Extensiones Personalizables.