{
"title": "Descripción general de la API de Freshservice: Una guía completa para desarrolladores para 2026",
"slug": "freshservice-api-overview",
"locale": "es",
"date": "2026-03-12",
"updated": "2026-03-12",
"template": "default",
"excerpt": "Una guía completa de la API de Freshservice que cubre los métodos de autenticación, los puntos finales centrales, los límites de velocidad y consejos prácticos de implementación para desarrolladores.",
"categories": [
"Guides"
],
"tags": [
"Freshservice",
"API",
"ITSM",
"Developer Guide",
"Integration"
],
"readTime": 9,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Descripción general de la API de Freshservice: Una guía completa para desarrolladores para 2026",
"description": "Una guía completa de la API de Freshservice que cubre los métodos de autenticación, los puntos finales centrales, los límites de velocidad y consejos prácticos de implementación para desarrolladores.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-562b5921-9ea4-4dfa-bdd4-1d95d5e4d11c"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-562b5921-9ea4-4dfa-bdd4-1d95d5e4d11c",
"coverImageAlt": "Imagen de banner para la descripción general de la API de Freshservice: Una guía completa para desarrolladores para 2026",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Preguntas frecuentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "¿Qué métodos de autenticación admite la API de Freshservice?",
"answer": "La API de Freshservice admite tres métodos de autenticación: autenticación de clave API mediante Basic Auth (autenticación básica) (recomendada para la mayoría de las integraciones), autenticación de nombre de usuario/contraseña y OAuth 2.0 para aplicaciones que requieren contexto de usuario. La autenticación de clave API es el enfoque más sencillo para las integraciones de servidor a servidor."
},
{
"question": "¿Cuáles son los límites de velocidad para la API de Freshservice?",
"answer": "Los límites de velocidad varían según el plan. Las cuentas Starter obtienen 100 solicitudes por minuto, Growth obtiene 200, Pro obtiene 400 y Enterprise obtiene 500. También hay sublímites para operaciones específicas como listar tickets o activos. Estos límites son para toda la cuenta, no por usuario."
},
{
"question": "¿Puedo usar la API de Freshservice para crear tickets automáticamente?",
"answer": "Sí, el punto final /api/v2/tickets admite solicitudes POST para crear tickets mediante programación. Puede especificar todas las propiedades del ticket, incluido el asunto, la descripción, el correo electrónico del solicitante, la prioridad, el estado y los campos personalizados. Esto se usa comúnmente para integrar herramientas de monitoreo y sistemas de alerta automatizados."
},
{
"question": "¿Cuál es la diferencia entre la API v1 y v2 de Freshservice?",
"answer": "La API v2 ofrece límites de velocidad significativamente más altos, un manejo de errores mejorado con códigos de estado HTTP adecuados, puntos finales adicionales para conversaciones y actualizaciones de tickets, soporte para tamaños de página de hasta 100 y conexiones solo HTTPS. La versión 1 está obsoleta y no debe usarse para nuevos proyectos."
},
{
"question": "¿Cómo manejo la paginación en la API de Freshservice?",
"answer": "Los puntos finales de la lista admiten la paginación mediante los parámetros de consulta page y per_page. El parámetro per_page acepta valores de hasta 100. Siempre implemente la paginación para las integraciones de producción, ya que intentar recuperar grandes conjuntos de datos en una sola solicitud fallará o agotará el tiempo de espera."
},
{
"question": "¿La API de Freshservice admite webhooks para notificaciones en tiempo real?",
"answer": "Sí, Freshservice admite configuraciones de webhook que pueden notificar a los sistemas externos cuando ocurren eventos de tickets. Esto suele ser más eficiente que sondear la API repetidamente para obtener actualizaciones. Los webhooks se pueden activar al crear, actualizar, cambiar el estado y otros eventos del ticket."
}
],
"supportLink": null
}
}
---
Si está creando integraciones con Freshservice, necesita comprender las capacidades de su API (Application Programming Interface). Ya sea que esté automatizando la creación de tickets, sincronizando datos de usuario o creando paneles personalizados, la API de Freshservice le brinda acceso programático a sus datos de administración de servicios de TI.
Analicemos lo que ofrece la API de Freshservice, cómo autenticarse, qué puntos finales están disponibles y cómo trabajar dentro de sus límites de velocidad. También veremos cómo herramientas como [eesel AI](https://www.eesel.ai/integration/freshservice-ai) pueden simplificar algunas de estas integraciones sin escribir código desde cero.
## ¿Qué es la API de Freshservice?
La [API de Freshservice](https://api.freshservice.com/) es una interfaz RESTful que le permite interactuar con su instancia de Freshservice mediante programación. Sigue las convenciones HTTP estándar, utiliza JSON para el intercambio de datos y admite la gama completa de operaciones CRUD (Crear, Leer, Actualizar, Eliminar).
Esto es lo que significa en la práctica. Usted puede:
- Extraer datos de tickets en herramientas de informes externas
- Crear tickets automáticamente a partir de alertas de monitoreo
- Sincronizar la información del usuario con su proveedor de identidad
- Actualizar registros de activos desde herramientas de descubrimiento
- Crear portales personalizados o aplicaciones móviles
Freshservice en realidad ofrece dos versiones de API. La versión 1 es la API heredada, que aún funciona pero es limitada. La versión 2 es la que debe usar para nuevos proyectos. Ofrece límites de velocidad más altos, mejor manejo de errores y más puntos finales. La API v2 solo acepta JSON y requiere conexiones HTTPS.
Freshservice también viene en tres versiones, cada una con un comportamiento de API ligeramente diferente:
- **Freshservice**: La plataforma ITSM estándar
- **Freshservice for Business Teams (FSBT)**: Diseñado para departamentos no relacionados con TI, como RR. HH. o Instalaciones
- **Freshservice for MSPs**: Creado para proveedores de servicios gestionados que gestionan varios clientes
La API central funciona igual en las tres, pero algunos puntos finales y terminología difieren. Por ejemplo, los MSP utilizan "Contactos" en lugar de "Solicitantes" y "Clientes" en lugar de "Espacios de trabajo".
## Métodos de autenticación
Antes de poder realizar cualquier llamada a la API, debe autenticarse. Freshservice ofrece algunas opciones según su caso de uso.
### Autenticación de clave API (recomendada)
Este es el enfoque más simple y común. Genere una clave API desde su perfil de Freshservice y luego inclúyala en sus solicitudes usando Basic Auth (autenticación básica).
Aquí le mostramos cómo encontrar su clave API:
1. Inicie sesión en su portal de Freshservice
2. Haga clic en su foto de perfil en la esquina superior derecha
3. Vaya a **Configuración de perfil**
4. Su clave API aparece debajo de la sección Cambiar contraseña
Una vez que tenga su clave, se autentica pasándola como nombre de usuario en un encabezado Basic Auth, con cualquier cadena (convencionalmente "X") como contraseña. Así es como se ve en la práctica:
```bash
curl -u "su_clave_api:X" \
-H "Content-Type: application/json" \
-X GET \
"https://sudominio.freshservice.com/api/v2/tickets"
O en JavaScript:
const apiKey = "su_clave_api_aqui";
const encodedKey = Buffer.from(apiKey + ":X").toString("base64");
fetch("https://sudominio.freshservice.com/api/v2/tickets", {
method: "GET",
headers: {
"Authorization": `Basic ${encodedKey}`,
"Content-Type": "application/json"
}
})
.then(response => response.json())
.then(data => console.log(data));
Autenticación de nombre de usuario y contraseña
También puede autenticarse utilizando sus credenciales de inicio de sesión de Freshservice. Esto funciona de la misma manera que la autenticación de clave API, pero en su lugar pasa su correo electrónico y contraseña:
curl -u "usuario@empresa.com:contraseña" \
-H "Content-Type: application/json" \
-X GET \
"https://sudominio.freshservice.com/api/v2/tickets"
OAuth 2.0
Para las aplicaciones que necesitan actuar en nombre de los usuarios (como las aplicaciones de marketplace), Freshservice admite OAuth 2.0. Esto es más complejo de configurar, pero proporciona una mejor seguridad para las integraciones orientadas al usuario.
Mejores prácticas de seguridad
Algunas cosas a tener en cuenta:
- Almacene las claves API de forma segura, nunca las guarde en el control de versiones
- Utilice HTTPS para todas las solicitudes (la v2 lo requiere)
- Rote las claves API periódicamente
- Utilice los permisos mínimos necesarios para su integración
- Considere la posibilidad de utilizar variables de entorno para el almacenamiento de claves
Puntos finales y capacidades principales de la API
La API de Freshservice cubre prácticamente todas las funciones de la plataforma. Estos son los principales puntos finales con los que trabajará.
Tickets
El punto final de los tickets es el más utilizado. Usted puede:
- Listar todos los tickets con filtrado y paginación
- Crear nuevos tickets mediante programación
- Actualizar las propiedades del ticket (estado, prioridad, asignado)
- Eliminar o restaurar tickets
- Agregar respuestas y notas
Una solicitud básica de creación de tickets se ve así:
fetch("https://sudominio.freshservice.com/api/v2/tickets", {
method: "POST",
headers: {
"Authorization": "Basic " + btoa("clave_api:X"),
"Content-Type": "application/json"
},
body: JSON.stringify({
email: "solicitante@ejemplo.com",
subject: "Nueva solicitud de computadora portátil",
description: "Necesito una computadora portátil nueva para el próximo proyecto",
priority: 2,
status: 2
})
});
Las propiedades del ticket utilizan valores numéricos para el estado y la prioridad:
| Estado | Valor |
|---|---|
| Abierto | 2 |
| Pendiente | 3 |
| Resuelto | 4 |
| Cerrado | 5 |
| Prioridad | Valor |
|---|---|
| Baja | 1 |
| Media | 2 |
| Alta | 3 |
| Urgente | 4 |
Usuarios y grupos
Administre su equipo de mesa de servicio y solicitantes:
- Agentes: Personal de TI que gestiona los tickets
- Solicitantes: Empleados que envían tickets
- Grupos: Equipos que gestionan tipos de tickets específicos
- Departamentos: Estructura organizativa
Activos
Rastree y administre los activos de TI durante todo su ciclo de vida:
- Crear y actualizar registros de activos
- Asociar activos con tickets
- Administrar las relaciones y dependencias de los activos
- Rastrear el mantenimiento y los contratos de los activos
Cambios y problemas
Para la gestión de cambios alineada con ITIL:
- Crear solicitudes de cambio
- Administrar los flujos de trabajo de aprobación de cambios
- Vincular los cambios a los tickets y problemas
- Rastrear el estado de la implementación
Catálogo de servicios
Automatizar las solicitudes de servicio:
- Listar los elementos de servicio disponibles
- Enviar solicitudes de servicio
- Rastrear el estado de aprobación de la solicitud
- Administrar los acuerdos de nivel de servicio
Conversaciones
Gestionar las comunicaciones de los tickets:
- Agregar respuestas públicas visibles para los solicitantes
- Agregar notas privadas para los equipos internos
- Adjuntar archivos a las conversaciones
- Reenviar tickets a terceros
Límites de velocidad y mejores prácticas
Freshservice impone límites de velocidad para garantizar la estabilidad de la plataforma. Estos varían según su plan y cuándo se creó su cuenta.
Límites de velocidad por plan
Para las cuentas creadas después del 1 de septiembre de 2020:
| Plan | Límite general (por minuto) | Operaciones de ticket/lista (por minuto) |
|---|---|---|
| Starter | 100 | 40 |
| Growth | 200 | 70 |
| Pro | 400 | 120 |
| Enterprise | 500 | 140 |
Tenga en cuenta que estos son límites para toda la cuenta, no por usuario o por IP. Cada llamada API desde su cuenta cuenta para la misma cuota.
Encabezados de límite de velocidad
Cada respuesta de la API incluye encabezados que muestran el estado actual de su límite de velocidad:
X-RateLimit-Total: El límite total de su cuenta por minutoX-RateLimit-Remaining: Solicitudes restantes en la ventana actualX-RateLimit-Used-CurrentRequest: Cuántas solicitudes consumió su última llamadaRetry-After: Segundos que debe esperar cuando ha alcanzado el límite (solo aparece en las respuestas 429)
Manejo de límites de velocidad
Cuando alcanza el límite, la API devuelve un código de estado 429. Su código debe manejar esto con elegancia:
async function makeRequestWithRetry(url, options, maxRetries = 3) {
let retries = 0;
while (retries < maxRetries) {
const response = await fetch(url, options);
if (response.status !== 429) {
return response.json();
}
const retryAfter = response.headers.get('Retry-After') || Math.pow(2, retries);
console.log(`Límite de velocidad alcanzado. Reintentando en ${retryAfter} segundos...`);
await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
retries++;
}
throw new Error('Se alcanzó el número máximo de reintentos');
}
Paginación
Los puntos finales de la lista devuelven resultados paginados. Utilice el parámetro page para navegar:
curl -u "clave_api:X" \
"https://sudominio.freshservice.com/api/v2/tickets?page=2&per_page=100"
La API v2 admite tamaños de página de hasta 100 registros. Siempre implemente la paginación para las integraciones de producción en lugar de asumir que obtendrá todos los resultados en una sola llamada.
Casos de uso comunes de integración
Estas son algunas formas prácticas en que las organizaciones utilizan la API de Freshservice:
Creación automatizada de tickets: Las herramientas de monitoreo como Datadog o PagerDuty pueden crear tickets automáticamente cuando se activan las alertas, lo que garantiza que los equipos de TI respondan rápidamente a los incidentes.
Aprovisionamiento de usuarios: Cuando se incorporan nuevos empleados, los sistemas de RR. HH. pueden crear cuentas de Freshservice automáticamente, asignándolas a los departamentos y grupos correctos según su función.
Sincronización de activos: Las herramientas de descubrimiento pueden insertar datos de activos en la CMDB de Freshservice, manteniendo actualizados los registros de inventario sin entrada manual.
Paneles personalizados: Las organizaciones extraen métricas de tickets en herramientas de inteligencia empresarial como Tableau o Power BI para la presentación de informes ejecutivos.
Integraciones de chatbot: Las herramientas de soporte impulsadas por IA pueden crear tickets a partir de conversaciones de chat, categorizándolos y enrutándolos automáticamente según el análisis de contenido.
Automatización del correo electrónico: Los correos electrónicos entrantes de dominios específicos o que contengan ciertas palabras clave pueden activar la creación de tickets con categorías y asignados precompletados.
Comenzando con su primera llamada API
¿Listo para probarlo usted mismo? Aquí hay una guía de inicio rápido.
Primero, tome su clave API de la configuración de su perfil de Freshservice. Luego, abra una terminal y ejecute este comando cURL (reemplace sudominio y su_clave_api):
curl -u "su_clave_api:X" \
-H "Content-Type: application/json" \
-X GET \
"https://sudominio.freshservice.com/api/v2/tickets?page=1&per_page=1"
Si todo funciona, obtendrá una respuesta JSON con su ticket más reciente.
Para la exploración, Postman es invaluable. Cree una nueva solicitud, configure la autenticación en Basic Auth con su clave API como nombre de usuario y "X" como contraseña, y comience a probar los puntos finales.
Freshworks también proporciona un SDK oficial de JavaScript/TypeScript que simplifica las interacciones de la API:
const { Freshservice } = require("@freshworks/api-sdk");
const fs = new Freshservice("sudominio", "su_clave_api");
// Obtener todos los tickets
const tickets = await fs.tickets.list();
Simplificación de las integraciones de Freshservice con eesel AI
La creación de integraciones de API desde cero requiere tiempo y recursos de ingeniería. Si necesita automatizar los flujos de trabajo de Freshservice sin escribir código, eesel AI ofrece un enfoque alternativo.
Nuestra plataforma se conecta directamente a Freshservice y proporciona automatización impulsada por IA para tareas comunes:
- Agente de IA: Gestiona de forma autónoma los tickets de soporte de primera línea, resolviendo problemas comunes sin intervención humana
- Copiloto de IA: Redacta respuestas para que sus agentes las revisen y envíen, lo que acelera los tiempos de respuesta
- Triaje de IA: Etiqueta, enruta y prioriza automáticamente los tickets entrantes según el contenido
En lugar de escribir llamadas API para crear tickets o actualizar campos, configura reglas de automatización en inglés sencillo. Por ejemplo: "Si un ticket menciona 'restablecimiento de contraseña' y proviene de un usuario VIP, asígnelo al grupo de soporte sénior y márquelo como de alta prioridad".
La configuración lleva minutos en lugar de semanas. Conecta su cuenta de Freshservice y nuestra IA aprende de sus tickets, artículos del centro de ayuda y macros existentes. No es necesario asignar puntos finales de API ni gestionar usted mismo la limitación de velocidad.
Para los equipos que necesitan integraciones de API personalizadas y automatización de IA, los enfoques se complementan entre sí. Utilice la API para la sincronización de datos y la comunicación de sistema a sistema, y eesel AI para el manejo inteligente de tickets y la redacción de respuestas.
Compartir esta entrada
Article by
