Il sistema distingue gli accessi API in base alla tipologia di operazione da eseguire, prevedendo due chiavi distinte:

·         UniversaRead, dedicata agli endpoint in lettura

·         UniversaWrite, dedicata agli endpoint in scrittura.

Gli endpoint associati alla chiave UniversaRead permettono esclusivamente il recupero di dati già presenti nel sistema PEOPLELINK. Si tratta quindi di API pensate per consultare informazioni, esportare dati o alimentare sistemi esterni, senza apportare modifiche ai dati presenti nell'impianto.

Gli endpoint associati alla chiave UniversaWrite, invece, permettono l'invio di dati verso PEOPLELINK con finalità di creazione, aggiornamento o, dove previsto, eliminazione. Le API di scrittura non operano come semplici chiamate dirette di salvataggio, ma sfruttano lo stesso sistema interno di import avanzato disponibile nel modulo DOCKS, già utilizzato per gli import da file.

Questo significa che i tracciati disponibili per la scrittura via API sono gli stessi previsti dagli import avanzati del portale, con la differenza che:

·         tramite interfaccia DOCKS i dati vengono forniti mediante file Excel

·         tramite API i dati vengono forniti in formato JSON.

La logica di validazione, elaborazione e controllo rimane coerente con quella dell'import avanzato. Ogni richiesta di scrittura viene analizzata e validata formalmente; se i dati risultano corretti, l'elaborazione viene inserita in una coda dedicata ed eseguita in modalità asincrona. Sarà poi possibile consultare lo stato dell'elaborazione tramite un apposito endpoint.

Le API di scrittura seguono una logica all-or-nothing: se durante la validazione o l'elaborazione viene rilevato anche un solo errore, l'intero import viene annullato e nessun dato viene scritto su PEOPLELINK. Gli import eseguiti tramite API, sia conclusi correttamente sia terminati con errori, possono essere consultati anche dal modulo DOCKS per un periodo determinato, con la possibilità di verificarne l'esito e i dati elaborati.

In conclusione, la chiave UniversaRead abilita l'accesso ai dati in sola consultazione, con model in response specifici per ogni endpoint, mentre la chiave UniversaWrite abilita operazioni di scrittura controllate, validate e tracciate attraverso il motore di import avanzato di PEOPLELINK, condiviso con quello in interfaccia di DOCKS.