Breadcrumbs

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:

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


Parametar

Format

Opis

timestamp

dd.MM.yyyy. HH:mm:ss

Dohvaća sve zapise izmijenjene nakon navedenog vremena.


🧪 Primjer poziva

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

PHP
/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.