Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Det mest interessante ved et response er ’entry’-elementerne. Hvert ’entry’-element indeholder et snapshot af en record fra registeret. Med snapshot menes, at det var sådan data så ud på et bestemt tidspunkt. Stamdata bruger fuld historik når man laver et udtag. Det vil sige at man f.eks. kan få information om hvordan en person record så ud for 1 år siden – med adresse, navn etc. Der er ingen garanti for hvor langt tilbage i tiden stamdata har information.

                                                                                   

Hvert entry element har et ’content’-element som indeholder alt domæne-data. I eksemplet ovenfor er det datatypen ’apotek’ som er indeholdt.

 

Det er to slags nøgler som identificerer en record: Unikke nøgler (indeks) og versionsnumre.

...

Versionsnumre bestemmer en record unikt indenfor en given datatype. Man kan se det som en primær nøgle i en database. Et versionsnummer er også en slags historisk ID. Det vil sige at det bestemmer en record unikt i historien, i modsætning til unikke nøgler. 

Versionsnummeret kan findes ved at kigge på entry-elementernes id-element. F.eks. i tag:trifork.com,2011:sor/apotek/v1/168763721800723
er 1687637218007236 versionsnummeret.

 

Med andre ord, bestemmer en unik nøgle en bestemt entitet, versionsnummeret bestemmer et snapshot af den entitet. Begge disse numre er vigtige på flere måder. Den unikke nøgle kan optræde i flere forskellige entry-elementer. Det er på grund af at en entitet ændre sig med tiden, men versionsnumre vil altid være forskellige.

...

Antallet af records i et register kan være meget stort, i visse tilfælde flere millioner records. Derfor bliver man nødt til at opdele et kopi-udtag i flere ’pages’.

                                                      

Response fra det tidligere eksempel, er et eksempel på en page. Når man er klar til at hente næste page sender men et request med nyt offset. Offset-parameteren i næste request sættes til det sidste versionsnummeret man har modtaget.

 

 Når Når man er klar til at

1.5    

...

Respons koder for webservicen

Status

Beskrivelse

200

OK, alt gik som forventet.

401

Der opstod en fejl som har med token og adgangstilladelse at gøre.

405

Der var en parameter i requestet. F.eks. en query-parameter, som ikke var valid.

5xx

Der opstod en anden fejl.