Usar nuestra API requiere conocimientos o experiencia previos en APIs y su manejo. Este artículo explica qué es la API de Teamtailor y cómo empezar a usarla.
¿Qué es la API de Teamtailor y qué hace?
Nuestra API abierta de Teamtailor sigue la especificación JSON API, y sirve para importar, editar y exportar información desde o hacia tu cuenta de Teamtailor. Esto puede incluir desde obtener una lista de vacantes, actualizar una vacante, modificar un usuario, o incluso crear uno nuevo.
Teamtailor ofrece distintas regiones para el procesamiento y almacenamiento de datos. La URL de la API que usarás en tus llamadas dependerá de la región donde esté almacenada tu cuenta.
Región Europa (Irlanda): api.teamtailor.com
Región Norteamérica (Oregón): api.na.teamtailor.com
Región Asia-Pacífico (Australia): api.au.teamtailor.com
Cómo empezar
Para usar nuestra API, debes generar una clave en Configuración → Integraciones → Claves API en tu cuenta de Teamtailor. Ten en cuenta que esta página solo es accesible para usuarios con acceso de Admin de la empresa.
Aquí puedes crear nuevas claves y eliminar las existentes. Recuerda que una vez creada una clave API, no se puede modificar, sólo eliminar.
Para crear una clave API, haz clic en + Nueva Clave API en la esquina superior derecha.
Hay tres tipos diferentes de claves, con diferentes permisos y alcances. Todo esto se explica en nuestra documentación aquí, y son los siguientes:
Permisos:
Público - acceso a todos los datos públicos disponibles en la página de empleo
Interno – acceso a datos públicos y privados (por ejemplo, vacantes internas no listadas, departamentos, ubicaciones)
Admin - acceso a todo en una cuenta
Tipos:
Leer - solo recuperar información y ‘leerla’
Escribir - solo crear nueva información
Leer/Escribir - puede hacer ambos
Ejemplo de caso de uso
Si, por ejemplo, quieres obtener una lista de vacantes a través de nuestra API y sólo te interesan las vacantes publicadas, es mejor usar una clave con permiso de Lectura Pública, que permite acceder a datos públicos en la página de empleo, como las vacantes visibles. Si en cambio necesitas obtener todas las ubicaciones, públicas o no, necesitarás una clave con permisos de al menos Lectura Interna.
Algunos datos están muy restringidos por motivos de seguridad (por ejemplo, la información de los candidatos) y sólo se pueden acceder con una clave con permiso de Administrador. Si ese es el caso, esto siempre se indica en la documentación de la API.
Soporte
Con todos los endpoints disponibles en nuestra documentación, cada acción necesaria está explicada con ejemplos que puedes probar si lo deseas.
Si tienes cualquier duda general sobre la documentación de la API, puedes contactarnos en support@teamtailor.com, pero ten en cuenta que no ofrecemos soporte para la implementación de la API.
Si algo no aparece en la documentación, probablemente no esté disponible para implementar. Scripts personalizados u otras integraciones pueden combinarse con las solicitudes disponibles en nuestros scripts públicos de API, sin embargo, cómo proceder es completamente decisión del cliente.
🤖 Este artículo ha sido traducido mediante IA. Avísanos si algo parece incorrecto.