Loading…
Tilbage

Digitaliser.dk - nu med offentligt API og medlemspolitik for grupper og rig tekstredigering


Den netop lancerede udgave af Digitalisér.dk indeholder en række nye og forbedrede features. Af disse kan bl.a. nævnes:

  • API: Til Digitalisér.dk er nu udviklet et REST-API, der muliggør en række af de væsentligste funktioner på Digitalisér.dk, som normalt foretages i brugergrænsefladen. Derudover er det bl.a. og muligt at foretage bulkoploads og lign. Du finder en API'et samt en basal dokumentation på http://api.digitaliser.dk/rest.
  • Medlemspolitik for grupper: Det er nu muligt for grupper at angive en medlemspolitik (fri adgang, per invitation eller per ansøgning) og tilsvarende muligt for brugere at blive medlem af grupper alt efter hvilken politik, der er angivet.
  • Ny tilstand for ressourcer: Der er indført en ekstra tilstand for ressourcer, så en ressource nu kan være publiceret til gruppen (og kun synlig for dens medlemmer).
  • Profil: På den personlige profil kan man nu angive titel og arbejdssted.
  • Gruppeadmin: Gruppeadministratorer kan nu moderere gruppens indhold.
  • Basal formattering af tekst: De fleste tekstfelter er nu forsynet med en simpel rich text editor, der gør det muligt at formattere tekst med fed, kursiv, lave lister og indsætte links.
  • Filvedhæftninger: Det er nu muligt at vedhæfte filer til indlæg og kommentarer.
  • Metadata til ressourcer: Antallet af metadata som kan angives til en ressource er blevet udvidet med lovhenvisning, kontaktoplysninger samt unikt id.

Foruden mængden af nye features er der også blevet rettet en lang række fejl. Hvis du har nogle spørgsmål eller kommentarer til ovenstående, er du velkommen til at skrive dem nedenfor.

Profilbillede

Tidsangivelser

John Gøtze

Jeg ser, at api'et spytter data ud med tidsangivelser som:

2010-07-19T13:09:37.632+02:00 og 

2010-07-19T13:13:26.415+02:00

Hvilken standard er det lige, der bruges her?

ISO 8601 med en afrundingsfejl?

Hej John

Bedre sent end aldrig :-)

Jeg kan ikke umiddelbart se problemet, så kan du give mig et hint om hvor afrundingsfejlen ligger? 

Med venlig hilsen

Brian

Profilbillede

API-kald til ressourcer

John Gøtze

Hvordan får man api'et til at vise nyeste ressourcer?

Jeg kan se man kan bruge http://api.digitaliser.dk/rest/resources/latest/rss?linkto=

men så er det jo RSS man får, og listen har ikke meget metadata med. Og hvad betyder linkto= egentlig?

Desuden kan jeg ikke se om man kan kvalificere feedet, f.eks. kun vise nye datakilder? 

 

Har skrevet lidt om mine erfaringer ovre på NemDigitaliser. For dem, der måtte være interesserede, her er de nyeste datakilder.

 

 

Profilbillede

API eksempler please

John Gøtze

Kunne nogen overtales til at komme med et par kodeeksempler på brugen af APIet på Digitalisér.dk?

Hvor finder man, eksempelvis, classificationId og resourceId?

Hej John

Jeg kan se at vi ladet dig lidt i stikken på dit spørgsmål. Her er til en start et par eksempler:

For at hente en ressourcer, eller rettere metadata om ressourcen anvendes GET på "resources/{id}".

Det 'id' (andre steder kaldet 'resourceId') som er angivet kan eksempelvis findes i URL'en på en kendt ressource, f.eks. "FORM-widget" med URL'en

http://digitaliser.dk/resource/448929

er id'et altså '448929' og kan hentes med en GET til URL'en:

http://api.digitaliser.dk/rest/resources/448929

og hvis man ønsker at hente det som det egentlig drejer sig om, selve artekfakten (den vedhæftede fil eller link), kan disse findes under '/Resource/ResourceArtefactHandleCollection/ArtefactHandle/@handleReference'

http://api.digitaliser.dk/rest/resources/448929/artefacts

 

Angående 'classificationId' så kan man se de klassifikationer som anvendes på digitaliser.dk ved at GET'te:

http://api.digitaliser.dk/rest/classifications

hvor vi pt. har to klassifikationer:

og disse er opbygget af et antal 'dimensioner', hvor hver dimension har en endelig liste af mulige udfald kaldet 'choices'. F.eks. kan man se hvilke udfald der findes for dimensionen Anbefalingsniveau

http://api.digitaliser.dk/rest/classifications/51572/dimensions/51507

at Obligatorisk har referencen "http://api.digitaliser.dk/rest/classifications/51572/dimensions/51507/choices/51503"

så hvis man vil fremsøge alle ressourcer som har den anbefalelsesgrad, kan man kalde

http://api.digitaliser.dk/rest/resources/search?classificationChoices=51503

bemærk at jeg brugte det sidste nummer (51503) fra reference til parameteren 'classificationChoices'.

Fra listen af søgeresultater kan man så vælge nogle ressourcer man vil have vist ved at følge '//@handleReference'.

 

Bemærk iøvrigt at vi har implementeret FORM 1.3 som en taxonomi.

http://api.digitaliser.dk/rest/taxonomies 

hvor der findes et sæt af REST operationer til at traversere og søge i disse, som er beskrevet sammen med de andre under http://api.digitaliser.dk/rest.