<?xml version="1.0" encoding="UTF-8"?>
<chapter version="5.0" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="cha_oai_pmh" xreflabel="OAI-PMH">
    <title>Bulk access via OAI-PMH</title>
    <para>
        <warning>
            <para>The OAI-PMH publisher is not currently supporting incremental harvesting.</para>
            <para>Although the usage of the OAI parameters 'from' and 'until' is handled by the OAI publisher, the datestamps of metadata records are updated about every week.</para>
            <para>We apologise for any inconvenience this may cause to harvesters,</para>
            <para>the OpenAIRE technical team.</para>
        </warning>
    </para>
    <para>OAI-PMH is a standard protocol for metadata publishing and harvesting. For details on the
        OAI-PMH protocol please refer to the official documentation at <link
            xlink:href="http://www.openarchives.org/OAI/openarchivesprotocol.html"/></para>
    <para>The OpenAIRE OAI-PMH endpoint is <link xlink:href="http://api.openaire.eu/oai_pmh"
        /></para>
    <para>For information about the endpoint check <link
            xlink:href="http://api.openaire.eu/oai_pmh?verb=Identify"/></para>
    <para>The updated list of OAI sets is always available at: <link
            xlink:href="http://api.openaire.eu/oai_pmh?verb=ListSets"/></para>
    <para>For quick reference, we report some of the likely more interesting sets:</para>
    <simplelist>
        <member>
            <emphasis>openaire</emphasis>: the set of publications. Metadata prefixes available:
            oaf, oai_dc</member>
        <member>
            <emphasis>FP7Publications</emphasis>: the set of publications funded by EC FP7. Metadata
            prefixes available: oaf, oai_dc</member>
        <member>
            <emphasis>H2020Publications</emphasis>: the set of publications funded by EC H2020.
            Metadata prefixes available: oaf, oai_dc</member>
        <member>
            <emphasis>openaire_data</emphasis>: the set of datasets. Metadata prefixes available:
            oaf, oai_datacite</member>
        <member>
            <emphasis>OpenAccess</emphasis>: the set of all Open Access publications and datasets.
            Metadata prefixes available: oaf (return datasets and publications), oai_dc (return
            datasets and publications), oai_datacite (return datasets only)</member>
        <member>
            <emphasis>projects</emphasis>: the set of all projects. Metadata prefix available:
            oaf</member>
        <member>
            <emphasis>ECProjects</emphasis>: the set of projects funded by the European Commission
            (EC) under the programmes FP7 and H2020. Metadata prefix available: oaf</member>
        <member>
            <emphasis>FP7Projects</emphasis>: the set of projects funded by the EC Seventh Framework
            Programme. Metadata prefix available: oaf</member>
        <member>
            <emphasis>H2020Projects</emphasis>: the set of projects funded by the EC Horizn 2020
            Programme. Metadata prefix available: oaf</member>
        <member>
            <emphasis>WTProjects</emphasis>: the set of projects funded by Wellcome Trust. Metadata
            prefix available: oaf</member>
    </simplelist>
    <para>For the list of available metadata prefixes, check: <link
            xlink:href="http://api.openaire.eu/oai_pmh?verb=ListMetadataFormats"/>.</para>
    <para>Note that records will always be available in the OpenAIRE format (<link
            xlink:href="https://www.openaire.eu/schema/0.2/oaf-0.2.xsd">schema</link>, <link
            xlink:href="https://www.openaire.eu/schema/0.2/doc/oaf-0.2.html">documentation</link>).
        The availability of records in oai_dc and oai_datacite depends on the typology of
        records.</para>
    <para>Publications are avaialble in oai_dc according to the <link
        xlink:href="https://guidelines.openaire.eu/en/latest/literature/index.html"
            >OpenAIRE3.0 guidelines for literature repositories</link>.</para>
    <para>Datasets are available in oai_datacite according to the <link
        xlink:href="https://guidelines.openaire.eu/en/latest/data/index.html"
            >OpenAIRE2.0 guidelines for data archives</link>. </para>
</chapter>
