# e-rara OAI

Basis-URL:  

	https://www.e-rara.ch/oai?

## OAI-Sets  

Komplette Liste der verfügbaren Sets: <br>
<a href="https://www.e-rara.ch/oai?verb=ListSets" target="_blank">https://www.e-rara.ch/oai?verb=ListSets</a>

### ZB-Sets  

Neben den auch via GUI verfügbaren Kollektionen gibt es weitere OAI-Sets, die sich durch ihre Herkunft definieren. Für die ZB gibt es drei solche Sets.  

#### zuz  

Enthält alle Ressourcen auf e-rara aus der Zentralbibliothek Zürich.  

#### nagezh  

Enthält Ressourcen der Naturforschenden Gesellschaft Zürich aus der Abteilung Alte Drucke und Rara.  

#### rheinau  

Enthält Ressourcen aus der Abteilung Alte Drucke und Rara, die ursprünglich aus dem Kloster Rheinau stammen.   

### Verfügbare Metadaten-Formate  

<a href="https://www.e-rara.ch/oai?verb=ListMetadataFormats" target="_blank">https://www.e-rara.ch/oai?verb=ListMetadataFormats</a>

Beispiel: 

    <metadataPrefix>mods</metadataPrefix>  

### Abfrage-Beispiele  

- GetRecord (identifier: VLID)<br> 
<a href="https://www.e-rara.ch/oai?verb=GetRecord&metadataPrefix=oai_dc&identifier=13434289" target="_blank">https://www.e-rara.ch/oai?verb=GetRecord&metadataPrefix=oai_dc&identifier=13434289</a><br><br>

- ListRecords<br><br>
Nach Zeitraum:<br>
<a href="https://www.e-rara.ch/oai?verb=ListRecords&metadataPrefix=oai_dc&from=2021-09-15&until=2021-09-22" target="_blank">https://www.e-rara.ch/oai?verb=ListRecords&metadataPrefix=oai_dc&from=2021-09-15&until=2021-09-22</a><br><br>

  Nach Set:<br>
  <a href="https://www.e-rara.ch/oai?verb=ListRecords&metadataPrefix=oai_dc&set=zuz" target="_blank">https://www.e-rara.ch/oai?verb=ListRecords&metadataPrefix=oai_dc&set=zuz</a><br><br>

  mit Resumption Token:<br>
  <a href="https://www.e-rara.ch/oai?verb=ListRecords&resumptionToken=0x411252638e27cbd42a98cf1473d26682-cursor_p_3D10_p_26set_p_3Dzuz_p_26from__p_3D2021-09-15T00_p_253A00_p_253A00Z_p_26metadataPrefix_p_3Doai_dc_p_26batch_size_p_3D11_p_26until_p_3D2021-09-22T23_p_253A59_p_253A59Z" target="_blank">https://www.e-rara.ch/oai?verb=ListRecords&resumptionToken=0x411252638e27cbd42a98cf1473d26682-cursor_p_3D10_p_26set_p_3Dzuz_p_26from__p_3D2021-09-15T00_p_253A00_p_253A00Z_p_26metadataPrefix_p_3Doai_dc_p_26batch_size_p_3D11_p_26until_p_3D2021-09-22T23_p_253A59_p_253A59Z</a><br><br> 

- ListIdentifiers<br> 
<a href="https://www.e-rara.ch/oai?verb=ListIdentifiers&set=zuz&metadataPrefix=oai_dc" target="_blank">https://www.e-rara.ch/oai?verb=ListIdentifiers&set=zuz&metadataPrefix=oai_dc</a><br><br>

- ListSets<br>
<a href="https://www.e-rara.ch/oai?verb=ListSets" target="_blank">https://www.e-rara.ch/oai?verb=ListSets</a><br><br>

  mit Resumption Token:<br>
  <a href="https://www.e-rara.ch/oai?verb=ListSets&resumptionToken=cursor_p_3D10_p_26batch_size_p_3D11" target="_blank">https://www.e-rara.ch/oai?verb=ListSets&resumptionToken=cursor_p_3D10_p_26batch_size_p_3D11</a><br><br>

- ListMetadataFormats<br>
<a href="https://www.e-rara.ch/oai?verb=ListMetadataFormats" target="_blank">https://www.e-rara.ch/oai?verb=ListMetadataFormats</a>

### e-rara Volltexte

Auf e-rara gibt es Volltextlinks im OAI-Record (METS-Format). 

Beispiel:<br/> 
<a href="https://www.e-rara.ch/oai?verb=GetRecord&metadataPrefix=mets&identifier=14257004" target="_blank">https://www.e-rara.ch/oai?verb=GetRecord&metadataPrefix=mets&identifier=14257004</a>

Allerdings sind hier nur Links für das Alto3-Format enthalten:

    <mets:fileGrp USE="FULLTEXT">
        <mets:file MIMETYPE="text/xml" CREATED="2021-11-19T01:25:42.612300Z" ID="ALTO14257006">
            <mets:FLocat xlink:href="https://www.e-rara.ch/zuz/download/fulltext/alto3/14257006" LOCTYPE="URL"/>
        </mets:file>
        <mets:file MIMETYPE="text/xml" CREATED="2021-11-19T01:25:46.098900Z" ID="ALTO14257007">
            <mets:FLocat xlink:href="https://www.e-rara.ch/zuz/download/fulltext/alto3/14257007" LOCTYPE="URL"/>
        </mets:file>
        <mets:file MIMETYPE="text/xml" CREATED="2021-11-19T01:25:34.983600Z" ID="ALTO14257008">
            <mets:FLocat xlink:href="https://www.e-rara.ch/zuz/download/fulltext/alto3/14257008" LOCTYPE="URL"/>
        </mets:file>
        <mets:file MIMETYPE="text/xml" CREATED="2021-11-19T01:25:35.658300Z" ID="ALTO14257009">
            <mets:FLocat xlink:href="https://www.e-rara.ch/zuz/download/fulltext/alto3/14257009" LOCTYPE="URL"/>
        </mets:file>
        ...
    </mets:fileGrp>

Zwar kann im jeweiligen Link 'alto3' durch 'plain' ersetzt werden:<br/>
<a href="https://www.e-rara.ch/zuz/download/fulltext/plain/14257009" target="_blank">https://www.e-rara.ch/zuz/download/fulltext/plain/14257009</a>

Jedoch ist der Text in Seiten unterteilt. Jede Seite hat eine eigene VLID. Obenstehender Link liefert den Text zu folgender Seite:<br/>
<a href="https://www.e-rara.ch/zuz/content/zoom/14257009" target="_blank">https://www.e-rara.ch/zuz/content/zoom/14257009</a>

In der Titelansicht gibt es einen Volltext-Link:<br/>
<a href="https://www.e-rara.ch/zuz/content/titleinfo/14257004" target="_blank">https://www.e-rara.ch/zuz/content/titleinfo/14257004</a>

Dieser enthält die VLID der ganzen Ressource:<br/>
<a href="https://www.e-rara.ch/zuz/download/fulltext/plain/14257004" target="_blank">https://www.e-rara.ch/zuz/download/fulltext/plain/14257004</a>

Um zu ermitteln, ob zu einem Titel ein Volltext verfügbar ist, kann also das OAI-Record auf den XML-Tag 

    <mets:fileGrp USE="FULLTEXT"> 

geprüft werden. Falls dieser vorhanden ist, kann mit der VLID aus dem Record-Header 

    <identifier>oai:www.e-rara.ch:14257004</identifier>

der gesamte Volltext abgefragt werden.