Este artículo explica cómo generar y gestionar credenciales para las API públicas de Personio. Las API permiten a Personio compartir datos con otros servicios o herramientas. Las credenciales de la API actúan como una clave que controla el flujo de información y decide qué se comparte.
Antes de empezar
- Para usar el Marketplace y configurar las integraciones, tienes que tener permisos de edición para Integración de Marketplace y la API.
- Para crear tu propia integración personalizada usando nuestra API pública, tienes que tener el plan Core Pro de Personio.
- Personio crea automáticamente credenciales de API para todas las integraciones, excepto para las personalizadas.
Más información sobre las credenciales de API
Las credenciales de la API crean conexiones y protegen la comunicación entre aplicaciones. En Personio, el sistema crea credenciales de API para lo siguiente:
- API de reclutamiento
- Integraciones de Personio
- Integraciones de socios de Personio
No puedes gestionar estas credenciales. Puedes actualizar estas integraciones a través del Marketplace de Personio. El sistema configura la mayoría de los permisos de acceso a la API en el nivel necesario para que la integración funcione. Por lo general, generas y administras las credenciales de API manualmente para las integraciones personalizadas.
Cómo funciona el acceso API para Integraciones personalizadas
Cuando configuras una integración personalizada, defina sus permisos de acceso (por ejemplo, si puede leer o escribir datos en áreas como Empleados, Registros de jornada, Ausencias y Documentos). La integración utiliza entonces sus credenciales API (ID de cliente y secreto API) para autenticar solicitudes API.
El acceso API funciona de manera diferente al acceso basado en roles de empleados en Personio. Los permisos de los roles de empleado controlan lo que los usuarios pueden ver y hacer en la interfaz de Personio, pero no controlan lo que las integraciones personalizadas pueden obtener a través de la API. Esto significa que no puedes limitar el acceso a la API únicamente a los empleados con un rol específico usando los permisos de los roles de empleado.
Genera credenciales de API para integraciones personalizadas
Para generar credenciales para integraciones personalizadas:
- Ve a Marketplace > Integraciones conectadas.
- Haz clic en Crear integración personalizada en la parte superior derecha de la pantalla. Este botón solo está disponible si tienes el plan Core Pro de Personio. Si no lo ves, comprueba el plan actual en Ajustes > Cuenta y ayuda > Suscripción y facturación para confirmar que tienes el plan Core Pro.
- Configura los ajustes.
Ten en cuenta que:
Los permisos de escritura no incluyen acceso de lectura. Si desea recuperar datos a través de nuestras API, también tiene que otorgar permisos de lectura.
La siguiente tabla muestra lo que cada permiso deja hacer a un sistema de terceros. Algunos permisos otorgan acceso de solo lectura. Para obtener detalles sobre los endpoint, visita el Centro de desarrolladores.
Permisos de integración |
Permisos de lectura | Permisos de escritura |
|---|---|---|
Empleados |
Permitir que los sistemas de terceros obtengan datos de Personio. | Permitir que los sistemas de terceros creen y actualicen datos en Personio. |
Registros de jornada |
Permitir que los sistemas de terceros obtengan datos de Personio. | Permitir que los sistemas de terceros creen, actualicen y eliminen datos en Personio. |
Ausencia |
Permitir que los sistemas de terceros obtengan datos de Personio. | Permitir que los sistemas de terceros creen y actualicen datos en Personio. |
Documentos |
Permitir que los sistemas de terceros obtengan ID de categoría de documento de Personio. | Permitir que los sistemas de terceros creen documentos en Personio. |
Informes personalizados |
Permitir que los sistemas de terceros recuperen todos los informes personalizados ya creados de Personio. Marca esta casilla para que todos los atributos de un informe personalizado sean recuperables. Esto se aplica incluso si no aparecen en atributos de empleado legibles. |
No aplicable. |
Reclutamiento |
Permitir que los sistemas de terceros obtengan datos de Personio. | Permitir que los sistemas de terceros creen y actualicen datos en Personio. |
Webhooks |
Recuperar metadatos del webhook. |
Crear, actualizar y eliminar webhooks. Los permisos de lectura y escritura no afectan al desencadenante de un webhook. Un webhook sigue funcionando después de que lo creas, sin importar la configuración de permisos. Obtén más información sobre los webhooks en nuestra documentación técnica. |
Unidades organizativas |
Permitir que los sistemas de terceros obtengan datos de Personio. | No aplicable. |
Entidades legales |
Permitir que los sistemas de terceros obtengan datos de Personio. | No aplicable. |
Centros de costes |
Permitir que los sistemas de terceros obtengan datos de Personio. | No aplicable. |
Centros de trabajo |
Permitir que los sistemas de terceros obtengan datos de Personio. | No aplicable. |
Informes |
Permitir que los sistemas de terceros obtengan datos de Personio. | No aplicable. |
Actualice las credenciales de la API para las integraciones personalizadas
Para actualizar los permisos de las integraciones personalizadas:
- Ve a Marketplace > Integraciones conectadas.
- Haz clic en la integración para actualizarla.
- En la ventana que aparece, realiza los cambios.
- Guarda los ajustes configurados.
También puedes restablecer las credenciales de API desde aquí siguiendo las instrucciones.
Desconecte o deshabilite las credenciales de la API para las integraciones personalizadas
Para desconectar o deshabilitar las credenciales de la API para las integraciones personalizadas:
- Ve a Marketplace > Integraciones conectadas.
- En la columna Acción, haz clic en los tres puntos.
- Haz clic en Deshabilitar para deshabilitar temporalmente las credenciales.
- Haz clic en Desconectar para eliminar las credenciales de forma permanente.
Acceder a la documentación técnica
Encuentra toda la documentación de la API en nuestro Centro para desarrolladores. Esto incluye endpoints, webhooks, detalles de datos y tutoriales. El Centro para desarrolladores tiene dos versiones con contenido diferente. La información de los webhooks está en la versión 2.0. Para cambiar de versión, haz clic en el número de versión en la parte superior de la página de inicio.