EmployerLastModifiedVersionNumbersByUser: Loket.nl REST itgen_loketnl_employerlastmodifiedversionnumbersbyuser_plural
read only REST
- Catálogo:
LoketNlRest - Esquema:
LastModifiedVersionNumbers - Etiqueta: itgen_loketnl_employerlastmodifiedversionnumbersbyuser_plural
Lista de números de versión de última modificación por empleador Nombre de la actividad : GetEmployerLastModifiedVersionNumbersByUser
¿Qué refleja el número de versión de 'última modificación'?
El número de secuencia de un empleador es un número secuencial que refleja si se han producido cambios en cualquiera de sus empleos SUBYACENTES.
Más concretamente, refleja el número de secuencia tras el último cambio de cualquier registro de la base de datos que se relacione con un empleo dentro de este empleador. Los datos de empleo que consideramos 'subyacentes' se basan en un conjunto predefinido de tablas y, por supuesto, en el id indicado. Este conjunto predefinido de tablas se puede consultar aquí
El objetivo de este conjunto predefinido es representar los datos de empleo 'estáticos' (vaste gegevens), por lo que excluye los datos de periodos de nómina (variabele gegevens).
Cuándo usar
Este endpoint es muy útil para integraciones que sincronizan periódicamente los datos de empleo de Loket con otro sistema. Como no hay webhooks disponibles, en la práctica estas integraciones tendrían que consultar periódicamente todos los datos para ver si hay cambios en los datos de empleo. El enfoque más elemental de obtener todos los datos de empleo en cada sincronización genera MUCHAS llamadas, en algunos casos incluso millones al día. Aunque podemos manejar bastante, esta no siempre es la forma deseada para el cliente ni para el servidor. Por tanto, este endpoint permite una solución alternativa para configurar dicha integración.
Cómo usar
Con cada actualización (incluidas las altas y bajas) el número de versión aumentará. Es decir, el número de versión NUNCA disminuye con el tiempo. (Tenga en cuenta que esto no solo es válido en el contexto de un único empleador (u otra entidad), sino que se aplica a todos los cambios en la base de datos). En consecuencia, en la práctica se usaría este endpoint para comprobar si algún número de versión de empLoyer ha aumentado aplicando el parámetro de filtro al campo version, por ejemplo ?filter=version gt 70429274.
Uso recomendado
- Realice su sincronización periódica de datos de empleo estáticos
- Almacene el número de versión más alto para el que ya ha procesado todos los cambios. (Puede usar el siguiente parámetro para hacerlo
?orderBy=-lastModifiedVersionNumber) - La próxima vez que desee realizar la sincronización. Llame a este endpoint con el parámetro
?filter=lastModifiedVersionNumber gt {{YourVersionNumber}} - Obtenga solo la información de empleo de los empleadores incluidos en esa lista filtrada. (excluya todos los demás empleadores, ya que sabe que no ha habido cambios desde la última sincronización)
Solo puede recuperar datos.
Fuente de la API
- Punto final:
/providers/employers/lastmodifiedversionnumbers - Operación:
get /providers/employers/lastmodifiedversionnumbers
Columnas de la Tabla
A continuación se muestran las columnas de la tabla EmployerLastModifiedVersionNumbersByUser. Cada columna tiene un tipo de datos SQL. Se debe proporcionar un nuevo valor no nulo para cada columna requerida en todo momento durante la inserción y la actualización.
| Name | Tipo de Datos | Label | Required | Marks | Documentation |
|---|---|---|---|---|---|
id |
guid |
ID | El identificador único de un objeto (GUID/UUID) | ||
last |
int64 |
itgen_loketnl_lastmodifiedversionnumber | El número de versión refleja la última versión de todas las tablas subyacentes predefinidas de este empleador/empleo. |
Notas de la Versión
Cambios introducidos en cada versión en las tablas, columnas, atributos y capacidades del controlador: