Kansalliskirjaston julkaisuarkistoissa on käytössä seuraavat OAI-PMH rajapinnat (esimerkit Doriasta, korvaa www.doria.fi -alku halutulla arkistolla): 

Alla esimerkkinä käytetään KK:n omaa formaattia. Se listaa julkaisuarkiston tiedot 100:n tietueen jaksoissa. ResumptionTokenin avulla voidaan aina hakea seuraava jakso. 


Ensimmäiset 100 saadaan seuraavasti:
https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=kk

Tämän jälkeen pitää tarkastaa ResumptionTokenin arvo ensimmäisen vastauksen lopusta eli:
<resumptionToken expirationDate="2013-01-23T10:05:47Z">0001-01-01T00:00:00Z/9999-12-31T23:59:59Z//kk/100</resumptionToken>

ja sen jälkeen seuraavat haetaan haulla, jossa XXX on edellisestä hausta saatu ResumptionTokenin arvo:
https://www.doria.fi/oai/request?verb=ListRecords&resumptionToken=0001-01-01T00:00:00Z/9999-12-31T23:59:59Z//kk/XXXXX

Jokaisen haun jälkeen tarkistetaan resumptionTokenin arvo ja seuraava haku tehdään sen avulla, kunnes resumptionToken on tyhjä eli kaikki tulokset on saatu.


Näin listaat kaikki serverin tukemat OAI-PMH metadataformaatit: 


https://www.doria.fi/oai/request?verb=ListMetadataFormats


Haravoinnin kohdistaminen tiettyyn yhteisöön  (setin edessä com_ -etuliite ennen handlea, handlen /-merkit korvattu _ -merkillä)


https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=kk&set=com_10024_lhandlen_loppuosa



Haravoinnin kohdistaminen tiettyyn kokoelmaan (setin edessä col_ etuliite ennen handlea, handlen /-merkit korvattu _ -merkillä)


https://www.doria.fi/oai/request?verb=ListRecords&metadataPrefix=kk&set=col_10024_handlen_loppuosa

Haravoinnin kohdistaminen tiettyyn tietueeseen (esimerkkinä dorian tietue) 

Muun arkiston ollessa kyseessä, korvaa molemmat kohdat, joissa doria.fi on mainittu, kyseisen arkiston nimellä. 

https://www.doria.fi/oai/request?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:www.doria.fi:10024/handlen_loppuosa


Hyödyllisiä linkkejä: