SOURCE: Vacation Tracker TITLE: ¿Cómo uso la API abierta (OpenAPI)? URL: https://vacationtracker.io/es/base-de-conocimientos/como-uso-la-api-abierta-openapi/ LANG: es PUBLISHED: 2026-10-06 UPDATED: 2026-10-06 READING: 4 min SUMMARY: Crea una clave API en el complemento API Abierta de Vacation Tracker, elige sus permisos, lee y modifica tus datos y recibe webhooks. # ¿Cómo uso la API abierta (OpenAPI)? # ¿Cómo uso la API abierta (OpenAPI)? Nuestro complemento API Abierta conecta Vacation Tracker con tus propias herramientas. Crea una clave API, elige qué puede hacer y úsala para leer y modificar tus datos o recibir avisos cuando algo cambie. ### Mira el tutorial Un breve recorrido por el complemento API Abierta: ## Cómo crear una clave API - Inicia sesión en tu cuenta de Vacation Tracker en app.vacationtracker.io/signin (https://app.vacationtracker.io/signin). - Abre Complementos en el menú de la izquierda. - En la pestaña Mis Complementos, busca API Abierta y haz clic en Ver. Si no aparece, búscalo en la pestaña Descubrir Más Complementos y actívalo primero. - En la sección Claves API, haz clic en Crear clave API. - Escribe un Nombre de la clave. Solo las personas de tu empresa ven este nombre. - Si quieres, escribe un Nombre de la integración. Aparece en Vacation Tracker junto a cada cambio que haga la clave, por ejemplo «Aprobado por Jane (a través de Payroll sync)». Déjalo vacío para mostrar solo el nombre de la persona. - En Permisos, elige una plantilla y ajústala si es necesario (ver más abajo). - En Caducidad, elige cuándo caduca la clave: en 30 días, en 90 días, en 1 año (recomendado) o nunca. - Revisa el Resumen y haz clic en Crear clave API. - Copia la clave y guárdala en un lugar seguro. La clave completa solo se muestra una vez, al crearla. ## Cómo elegir los permisos Empieza con una plantilla y luego ajústala: - Solo lectura: ver los datos sin cambiar nada. Ideal para informes y paneles. - Gestión de ausencias: solicitar, añadir y aprobar ausencias. Leer usuarios y tipos de ausencia. - Configuración del espacio de trabajo: configurar ubicaciones, departamentos, tipos de ausencia, políticas, festivos y usuarios. - Personalizado: elegir cada permiso por tu cuenta. Cada permiso se puede configurar como Sin acceso, Lectura o Lectura y escritura. Aprobar y rechazar solicitudes, ver los nombres de los tipos de ausencia ocultos y actuar en nombre de otros usuarios son casillas independientes, así que actívalas solo si tu herramienta las necesita. Una clave solo puede hacer lo que tú tienes permitido hacer en Vacation Tracker. ## Cómo gestionar tus claves La tabla Claves API muestra todas las claves de tu espacio de trabajo con su propietario, sus permisos, su último uso, su fecha de caducidad y su estado. Haz clic en una clave para abrir sus detalles, donde puedes: - Ver el uso de este mes y editar el nombre y los permisos de la clave. - Consultar la Actividad reciente, que muestra cada solicitud que ha modificado datos. - Hacer clic en Rotar clave para obtener una clave nueva con el mismo nombre y los mismos permisos. Elige si la clave anterior sigue funcionando durante 24 horas (recomendado), durante 7 días o deja de funcionar al instante. - Hacer clic en Revocar para desactivar la clave de forma definitiva. Te enviamos un correo electrónico 14 días antes de que caduque una clave. ## Tu primera solicitud La URL base es https://api.vacationtracker.io/v2. Envía tu clave como token bearer en el encabezado Authorization: curl https://api.vacationtracker.io/v2/departments \ -H "Authorization: Bearer vt_live_..." Una llamada correcta devuelve los datos en data. Las listas con más páginas incluyen también un nextToken, que debes enviar de vuelta para obtener la página siguiente. { "data": [ ... ], "nextToken": "..." } Si algo sale mal, la respuesta incluye un error con un código, una descripción y una solución. Una clave ausente o desconocida devuelve el código 401. Una clave sin el permiso que necesita una solicitud devuelve el código 403 con INSUFFICIENT_SCOPE. Referencia técnica completa Todos los endpoints, parámetros, códigos de error y eventos de webhook están en nuestra documentación para desarrolladores (https://vacationtracker.io/developers/api-v2). También puedes abrirla con el botón Abrir documentación de la página del complemento API Abierta. ## Cómo añadir un webhook - En la página del complemento API Abierta, ve a Webhooks y haz clic en Gestionar webhooks. - Haz clic en Añadir webhook. - Introduce la URL del endpoint que recibirá los eventos. Debe usar HTTPS. - En Eventos, elige Decisiones sobre ausencias, Toda la actividad de ausencias, Mantener una copia completa sincronizada o Personalizado para elegir los eventos por tu cuenta. - Haz clic en Añadir webhook. Solo recibes eventos de los datos que tienes permitido ver. ## Cuotas y límites de uso Los límites se aplican por clave API: - Hasta 30 000 solicitudes al mes. - 10 solicitudes por segundo, con picos de hasta 50 solicitudes. Si tu integración necesita más, escribe a developers@vacationtracker.io (mailto:developers@vacationtracker.io) indicando el nombre de tu empresa, la integración y el tráfico que esperas. Claves API antiguas Las claves creadas antes de la API v2 aparecen en Claves heredadas (API v1). Siguen funcionando, pero solo pueden leer datos y no funcionan con la API v2. Para modificar datos a través de la API, crea una clave nueva y sigue nuestra guía de migración (https://vacationtracker.io/developers/api-v2/migration). ## Preguntas frecuentes ¿Debo usar la API, Zapier o el servidor MCP? Depende de lo que quieras hacer. La API es para tu propio código y tus herramientas, con webhooks para reaccionar a los cambios. Zapier es la opción sin código. El servidor MCP conecta una herramienta de IA como Claude o ChatGPT para que puedas hacer preguntas en lenguaje natural. Muchos equipos usan más de una opción. ¿La API tiene algún coste adicional? No. El complemento API Abierta está incluido en los planes Core y Complete sin coste adicional. ¿Qué pasa si pierdo una clave? La clave completa solo se muestra una vez y no se puede recuperar. Abre la clave y haz clic en Rotar clave para obtener una nueva y, después, actualiza la herramienta que la usa. Si la clave anterior puede haberse filtrado, elige desactivarla al instante. ### Siguientes pasos ¿Cómo conecto Vacation Tracker a Zapier? (https://vacationtracker.io/es/base-de-conocimientos/como-conecto-vacation-tracker-a-zapier/) ¿Cómo conecto Vacation Tracker a mis herramientas de IA con el servidor MCP? (https://vacationtracker.io/es/base-de-conocimientos/como-conecto-vacation-tracker-a-mis-herramientas-de-ia-con-el-servidor-mcp/) ¿Cómo exporto un informe de solicitudes de ausencia (historial de ausencias)? (https://vacationtracker.io/es/base-de-conocimientos/como-exporto-un-informe-de-solicitudes-de-ausencia-historial-de-ausencias/) ¿Necesitas ayuda? Contacta con nuestro equipo de soporte por correo electrónico o por chat, de lunes a viernes, de 9:00 a 17:00 (hora del Este, EST).