# Open Archives Initiative Protocol for Metadata Harvesting

Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) est un protocole informatique développé par l'Open Archives Initiative afin d'échanger des métadonnées. Il permet de constituer et de mettre à jour automatiquement des entrepôts centralisés où les métadonnées de sources diverses peuvent être interrogées simultanément. Utilisé notamment par les Archives Ouvertes et les entrepôts institutionnels, il s'est aujourd'hui largement répandu dans les institutions patrimoniales et notamment les bibliothèques. Utilisé également par les moteurs de recherche, il peut être défini comme un dispositif d'API spécialisé pour les métadonnées documentaires.

## Histoire

L'OAI-PMH a été mis au point par l'Open Archive Initiative à la suite de la convention de Santa Fe (1999). À la suite des travaux de l'OAI, une première version du protocole (1.0) a été rendue publique en janvier 2001. En juillet de la même année, des changements mineurs ont été apportés au protocole (version 1.1) afin de prendre en compte des modifications apportées par le W3C au format XML. Enfin, en juin 2002 a été publiée la version actuelle (2.0), qui introduit plusieurs changements techniques et améliorations, et n'est pas rétrocompatible avec les versions précédentes. Cette version est considérée comme définitive.

## Fonctionnement
### Principe

Ce protocole repose sur la présence de deux types d'acteurs distincts : les fournisseurs de données et les fournisseurs de service (moissonneurs). Les premiers vont donner accès à leur catalogue à travers ce que l'on nomme un « entrepôt OAI », un outil chargé de répondre aux requêtes formulées par les fournisseurs de service.
La réponse donnée est au format XML et contient selon la requête formulée : des informations sur l'entrepôt, une liste d'identifiants, de références (métadonnées) ou de « sets » (regroupement de notices, ou <record>, correspondant à un thème donné ou un ensemble de notices faisant sens intellectuellement).
Le fournisseur de données doit fournir ses données au format Dublin Core à minima mais peut, s'il le souhaite, proposer en supplément d'autres schémas : BiblioML, MarcXML, Dublin Core TERMS, etc. La liste des formats disponibles pour un entrepôt peut être obtenue à l'aide de la commande ListMetadataFormats (voir ci-dessous).

### L'interrogation en OAI-PMH

Un moissonneur pour interroger un entrepôt OAI utilise une requête sous la forme d'une URL classique construite en deux parties : L'url de base de l'entrepôt et la requête d'interrogation à proprement parler. Cette seconde partie se construit à partir de différents verbes prévus par le protocole et listés dans le tableau suivant :
| Verbe | Rôle | Arguments |
| GetRecord | Récupération d'un enregistrement donné. | identifier metadataPrefix |
| Identify | Informations sur l'entrepôt de données. | Aucun |
| ListIdentifiers | Récupère la liste des identifiants disponibles. | from : date de début until : date de fin metadataPrefix set resumptionToken |
| ListMetadataFormats | Demande la liste des formats de métadonnées disponibles. Sans paramètres tous les formats disponibles pour au moins un item sont retournés. Avec le paramètre identifier, ne sont retournés que les formats disponibles pour l'item concerné | identifier |
| ListRecords | Retourne une liste d'enregistrements correspondant aux différents paramètres (dates, ensemble) demandés. | from : date de début until : date de fin metadataPrefix set resumptionToken |
| ListSets | Demande la liste des ensembles disponibles sur un entrepôt. La réponse peut être sur plusieurs pages. | resumptionToken |
Ainsi pour obtenir des informations générales sur l'entrepôt OAI-PMH @archiveSIC, aujourd'hui dans HAL (entrepôt francophone spécialisé en Sciences de l'Information et de la Communication) la requête à utiliser est la suivante :
https://api.archives-ouvertes.fr/oai/hal/?verb=Identify
Par la suite, la combinaison des verbes avec leurs différents arguments permet d'obtenir des ensembles précis et de récupérer les métadonnées descriptives contenues dans l'entrepôt.

## Usages

L'OAI-PMH est à la base du moissonnage des métadonnées pour la construction de moteurs de recherche et portails académiques et patrimoniaux.

## La communauté OAI-PMH
### Enregistrement des sites OAI-PMH

Le protocole OAI est maintenant de plus en plus utilisé au niveau mondial par de nombreux acteurs du monde des archives ouvertes et des bibliothèques numériques. Pour favoriser la coopération des sites ayant une interface OAI-PMH, l'enregistrement est vivement encouragé.
Voici quelques exemples d'annuaires de sites compatibles OAI-PMH :
* la liste maintenue par l'initiative « The Open Archives » ;
* le registre de l'université de l'Illinois à Urbana-Champaign ;
* The Celestial OAI registry ;
* Eprint’s Institutional Archives Registry ;
* Openarchives.eu : le répertoire européen des référentiels OAI-PMH dans le monde ;
* A worldwide service and registry : ScientificCommons.