Dohvat samo izmijenjenih podataka

📌 Što je dohvat samo izmijenjenih podataka?

Luceed API omogućuje dohvat samo onih zapisa koji su izmijenjeni ili dodani nakon određenog vremena, čime se postiže inkrementalna sinkronizacija – selektivno dohvaćanje promjena umjesto kompletnog skupa podataka.

Ova funkcionalnost se ostvaruje korištenjem timestamp parametra u API pozivu, a značajno smanjuje količinu prenesenih podataka, što je posebno korisno za web trgovine i druge sustave koji se često sinkroniziraju s Luceedom.

🔧 Kako koristiti timestamp?

Timestamp se dodaje kao parametar u API poziv:

?timestamp=dd.MM.yyyy. HH:mm:ss 

🧪 Primjer poziva

Poziv koji vraća zapise koji su izmijenjeni ili dodani nakon određenog vremena:

/datasnap/rest/<metoda>/<vrijednost>?timestamp=22.03.2025. 10:45:12

📘 Podržane metode

Timestamp dohvat trenutno je dostupan na određenim metodama, a podrška će se s vremenom proširivati.
Točne metode koje podržavaju timestamp parametar navedene su u Luceed API dokumentaciji.

🧠 Što se smatra izmjenom?

Kada koristite timestamp dohvat, Luceed API vraća:

• zapise koji su izmijenjeni nakon navedenog vremena,

• zapise koji su dodani nakon navedenog vremena,

• cijeli šifrarnik (ili drugi skup podataka) ako je došlo do promjene u strukturi poruke (npr. dodano/uklonjeno polje u odgovoru).

Što nije uključeno?

Dohvat putem timestamp parametra ne uključuje obrisane zapise, jer odgovor sadrži samo trenutno postojeće zapise.

✅ Preporuke za integratore

Da biste osigurali potpunu i pouzdanu sinkronizaciju podataka, preporučujemo sljedeće:

1. Pohranite timestamp
   Zabilježite timestamp iz zadnjeg uspješnog poziva i koristite ga u sljedećem pozivu.

2. Povremeno dohvatite kompletne liste (ako je nužno)

   Ako korisnik od kojeg dohvaćate zapise u Luceedu prakticira brisanja ili pretapanja zapisa, povremeno napravite potpuni dohvat šifrarnika. Obrisane zapise tada predstavlja razlika između prethodnog i novog skupa podataka.

3. Preporučite korisnicima da deaktiviraju umjesto da brišu
   Ako je moguće, dogovorite s korisnicima da ne brišu i ne pretapaju zapise, nego da ih deaktiviraju.
   Tako ćete i dalje moći uočiti promjene putem timestamp dohvata.