Este artículo explica cómo generar y gestionar credenciales para las API públicas de Personio.
Más información sobre las credenciales de API
Las API permiten a Personio compartir datos con otros servicios o herramientas. Las credenciales de API actúan como una llave. Controlan el flujo de información y deciden qué se comparte. Estas credenciales crean conexiones y protegen la comunicación entre aplicaciones.
Gestionar las credenciales de API en Personio
En Personio, el sistema crea credenciales de API para lo siguiente:
-
- API de reclutamiento
- Integraciones de Personio
- Integraciones de socios de Personio
No puedes administrar estas credenciales tú mismo. Puedes actualizar estas integraciones a través del Marketplace de Personio. El sistema establece la mayoría de los permisos de acceso a la API al nivel necesario para que la integración funcione. Por lo general, generas y administras las credenciales de API manualmente para las integraciones personalizadas.
Genere credenciales de API para integraciones personalizadas
Personio crea automáticamente credenciales de API para todas las integraciones, excepto para las 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.
- Configura los ajustes.
| Permisos de acceso a la 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. |
| Ausencias |
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 existentes 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. |
| 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. |
Gestionar credenciales de API para integraciones personalizadas
Para actualizar los permisos de acceso para 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.
Desconectar o deshabilitar las credenciales de API
- 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.