EmployerLastModifiedVersionNumbersByUser : Loket.nl REST itgen_loketnl_employerlastmodifiedversionnumbersbyuser_plural
read only REST
- Catalogue :
LoketNlRest - Schéma :
LastModifiedVersionNumbers - Étiquette : itgen_loketnl_employerlastmodifiedversionnumbersbyuser_plural
Liste des numéros de version des dernières modifications de l'employeur Nom de l'activité : GetEmployerLastModifiedVersionNumbersByUser
Ce que reflète le numéro de version « dernière modification »
Le numéro de séquence d'un employeur est un numéro séquentiel qui indique si des modifications ont eu lieu dans l'un de ses emplois SOUS-JACENTS.
Plus précisément, il reflète le numéro de séquence après la dernière modification de tout enregistrement de base de données lié à un emploi au sein de cet employeur. Ce que nous considérons comme données d'emploi « sous-jacentes » repose sur un ensemble prédéfini de tables et, bien sûr, sur l'identifiant donné. Cet ensemble prédéfini de tables se trouve ici
Le périmètre de cet ensemble prédéfini est de représenter les données d'emploi « statiques » (vaste gegevens), et exclut donc les données de période de paie (variabele gegevens).
Quand utiliser
Ce point de terminaison est particulièrement utile pour les intégrations qui synchronisent régulièrement les données d'emploi Loket avec un autre système. Comme aucun webhook n'est disponible, en pratique ces intégrations devraient interroger régulièrement toutes les données pour voir s'il y a des modifications dans les données d'emploi. L'approche la plus élémentaire consistant à obtenir toutes les données d'emploi à chaque synchronisation nécessite un très grand nombre d'appels, dans certains cas plusieurs millions par jour. Même si nous pouvons gérer un volume important, ce n'est pas toujours la méthode souhaitable pour le client comme pour le serveur. Ainsi, ce point de terminaison offre une solution alternative pour mettre en place une telle intégration.
Mode d'emploi
À chaque mise à jour (y compris les ajouts et suppressions), le numéro de version augmentera. Autrement dit, le numéro de version ne diminuera JAMAIS au fil du temps. (Notez que ceci vaut non seulement dans le contexte d'un seul employeur (ou de toute autre entité), mais s'applique à toutes les modifications de la base de données). Par conséquent, en pratique, on utilisera ce point de terminaison pour vérifier si des numéros de version de empLoyer ont augmenté, en appliquant le paramètre de requête de filtre au champ de version, par exemple ?filter=version gt 70429274.
Utilisation recommandée
- Effectuez votre synchronisation régulière des données d'emploi statiques
- Conservez le numéro de version le plus élevé pour lequel vous avez maintenant traité toutes les modifications. (Vous pouvez utiliser le paramètre suivant pour ce faire
?orderBy=-lastModifiedVersionNumber) - Lors de votre prochaine synchronisation. Appelez ce point de terminaison avec le paramètre
?filter=lastModifiedVersionNumber gt {{YourVersionNumber}} - Ne récupérer les informations d'emploi que pour les employeurs figurant dans cette liste filtrée. (exclure tous les autres employeurs, car vous savez déjà qu'il n'y a eu aucune modification depuis la dernière synchronisation)
Permet uniquement de récupérer des données.
Source de l'API
- Point de terminaison :
/providers/employers/lastmodifiedversionnumbers - Opération :
get /providers/employers/lastmodifiedversionnumbers
Colonnes de table
Les colonnes de la table EmployerLastModifiedVersionNumbersByUser sont présentées ci-dessous. Chaque colonne possède un type de données SQL. Une nouvelle valeur non nulle doit être fournie pour chaque colonne requise à tout moment lors de l'insertion et de la mise à jour.
| Name | Type de données | Label | Required | Marks | Documentation |
|---|---|---|---|---|---|
id |
guid |
ID | L'identifiant unique d'un objet (GUID/UUID) | ||
last |
int64 |
itgen_loketnl_lastmodifiedversionnumber | Le numéro de version reflète la dernière version de toutes les tables prédéfinies sous-jacentes de cet employeur/emploi. |
Notes de Version
Quels ont été les changements apportés à chaque version au niveau des tables, des colonnes, des attributs et des fonctionnalités du chauffeur :