Este artículo proporciona una introducción a las API públicas de Personio, los webhooks y el Developer Hub. Las API permiten que las aplicaciones de software interactúen y compartan datos. Las API públicas de Personio permiten el intercambio de datos entre Personio y otros servicios o herramientas. Proporcionan endpoints para recuperar y editar datos de tu cuenta de Personio.
Consejo:
El Developer Hub es el lugar principal para obtener información sobre las API y los webhooks de Personio.
Acceder a las API públicas de Personio
Para acceder a la información sobre las API públicas y los webhooks de Personio, ve al Developer Hub. Este es el lugar principal para obtener información sobre las API y los webhooks de Personio y sirve como recurso central para obtener documentación detallada.
Versiones de API públicas de Personio
Personio tiene dos versiones de API con diferentes puntos finales de API:
- Las API v1 mantienen las integraciones ya configuradas, lo que garantiza la estabilidad y una amplia funcionalidad.
- Las API v2 introducen nuevas funciones y amplían las capacidades de integración.
Ambas versiones de la API trabajan juntas para darte más funcionalidades y más estabilidad. Puedes usar las mismas credenciales de la API para v1 y v2 (no es necesario registrarse por separado ni generar otras credenciales para usar v2). La API v2 se encuentra en beta en estos momentos. Los endpoints están disponibles, pero siguen en desarrollo activo.
Ejemplos de API v1 y v2
Ten en cuenta que:
El 31 de julio de 2027 suspenderemos algunos endpoints de la API v1 de Registros de jornada y Proyectos. Solo se van a retirar estos endpoints. Los demás endpoints de v1 siguen disponibles. Puedes ver si esto afecta a la cuenta en Ajustes > Seguridad e integraciones > Credenciales de la API revisando las credenciales de la API activas. Si la integración personalizada utiliza estos endpoints, pide al equipo de IT que migre a los equivalentes de v2.
- Registros de jornada: sustituye las llamadas de endpoint de registro de jornada de v1 por /v2/attendance-periods
- Proyectos: sustituye las llamadas de endpoint de proyectos de v1 por /v2/projects
Para conocer todos los detalles técnicos, consulta en el Centro de desarrollo (Developer Hub).
Esta tabla muestra ejemplos de las API disponibles para cada versión. Para obtener una lista completa de las funcionalidades de la API y los endpoints, consulta el Developer Hub.
| Versión de la API | API | Ejemplos de funcionalidad |
|---|---|---|
v1 |
Personas |
|
v1 |
Ausencia |
|
v2 |
Registros de jornada |
|
v2 |
Proyectos |
|
v2 |
Gestión de documentos |
|
v2 |
Empleos |
|
v2 |
Puestos |
|
v2 |
Bandas salariales |
|
v2 |
Informes |
|
Credenciales de API
Encontrarás más información en el artículo Generar y administrar credenciales de API. Ten en cuenta que para construir tu propia integración personalizada utilizando nuestra API pública, necesitas el plan CorePro Personio.
Webhooks
Los webhooks son una parte específica de las API públicas de Personio. Los webhooks envían datos desde Personio a tu aplicación o base de datos cuando suceden eventos específicos. Visita el Developer Hub (v2) para obtener una lista completa de webhooks y detalles sobre cómo funcionan.
El Developer Hub
El Developer Hub tiene la información más reciente sobre las API públicas y los webhooks de Personio. El Developer Hub tiene dos versiones:
- Developer Hub (v1) es compatible con las API ya configuradas.
- El Developer Hub (v2) presenta nuevas API y webhooks.
Para acceder a los archivos OpenAPI v2, ve a developer.personio.de/openapi.
Más información