Points d’accès standardisés aux données de NAKALA (métadonnées et/ou fichiers)¶

Entrepôt OAI-PMH de NAKALA¶

• NAKALA fournit une exposition OAI des données publiques. Le point d’accès de cet entrepôt est : https://api.nakala.fr/oai2?verb=Identify

• Trois formats de métadonnées sont moissonnables :

  • En Dublin Core : oai_dc,

  • Exemple d’une collection exposée en Dublin Core : https://api.nakala.fr/oai2?verb=ListRecords&metadataPrefix=oai_dc&set=10.34847/nkl.d972955s

  • En Dublin Core qualifié (DCTerms) : oai_qdc,

  • Exemple d’une collection exposée en DCTerms : https://api.nakala.fr/oai2?verb=ListRecords&metadataPrefix=oai_qdc&set=10.34847/nkl.d972955s

  • Au format de DataCite : oai_datacite,

  • Exemple d’une collection exposée en DataCite : https://api.nakala.fr/oai2?verb=ListRecords&metadataPrefix=oai_datacite&set=10.34847/nkl.d972955s

• Les « Sets » (ensembles) correspondent aux collections publiques de NAKALA. Chaque collection publique constitue un set OAI dans l’entrepôt OAI de NAKALA.

• Fichiers du mapping des métadonnées à télécharger : tableaux de correspondances entre les propriétés de description des dépôts de NAKALA et les propriétés des différents modèles utilisés dans le cadre du protocole OAI-PMH (oai_dc, qdc et oai_datacite) :

  • fichier du mapping au format csv
  • ficher du mapping au format xlsx

Triplestore¶

Les données de Nakala sont exposées dans une base de données structurée au format RDF ou triplestore, selon les principes du web sémantique. Elle contient les informations de l’ensemble des dépôts publics de Nakala. Les dépôts privés et les dépôts supprimés en sont donc exclus.

Le modèle de données de Nakala est inspiré du modèle EDM (Europeana Data Model), développé par le projet Europeana. Il se compose principalement des vocabulaires et ontologies suivants :

• Dublin Core
• FOAF (Friend of a Friend)
• SKOS (Simple Knowledge Organization System)
• ORE (Object Reuse and Exchange)
• WS84

Pour plus de détails, l’ensemble des classes et propriétés utilisées sont décrites dans une page dédiée.

Le triplestore est interrogeable avec :

• le protocole et langage SPARQL à l’adresse suivante : https://nakala.fr/sparql
• l’outil Sparnatural, développé par la société Sparna, accessible à l’adresse suivante : https://nakala.fr/sparnatural, qui permet une aide graphique à la saisie des requêtes SPARQL et propose un panel d’exemples de requêtes.

Enfin, les spécifications du protocole et langage SPARQL peuvent être consultées sur le site du consortium W3C.

API de NAKALA¶

Les APIs (Application Programming Interface) sont des interfaces qui permettent une communication machine à machine.

Le point d’accès et la description des verbes API de NAKALA est : https://api.nakala.fr/doc

NAKALA fournit des API permettant d’interagir avec les données :

• search : Recherche données et collections de Nakala
• datas : Gestion des données
• collections : Gestion des collections
• groups : Gestion des groupes d’utilisateurs
• users : Gestion des utilisateurs
• vocabularies : Accès aux vocabulaires de Nakala

Certaines opérations nécessitent de disposer d’un compte dans NAKALA et d’utiliser sa clé d’API (disponible dans son compte personnel)

• Tutoriel d’utilisation de l’API NAKALA présenté lors de l’ANF 2021 : https://gitlab.huma-num.fr/huma-num-public/notebook-api-nakala

API IIIF¶

IIIF (International Image Interoperability Framework) définit un cadre d’interopérabilité pour le traitement et la manipulation d’images. Les spécifications définissent différentes API (Image, Presentation et Search) permettant des manipulations du type (pour l’API Image) :

• Sélectionner une partie de l’image (region)
• Modifier la taille de l’image (taille)
• Faire pivoter l’image (rotation)
• Choisir la qualité de l’image (qualite)
• Choisir le format (format)

La mise en oeuvre de IIIF dans NAKALA¶

Seule l’API Image est proposée dans une mise en oeuvre avec le serveur Cantaloupe. Les extensions de fichiers images supportées sont : tif, tiff, jpg, jpeg, jp2, png, pdf et geojp2

Construction des URLs pour utiliser IIIF Image¶

• L’URL suit la syntaxe suivante :

https://api.nakala.fr/iiif/[identifiant]/[identifiant_fichier]/{region}/{taille}/{rotation}/{qualité}.{format}.

• Exemples d’URL :

Les exemples sont donnés avec l’image https://api.nakala.fr/data/10.34847/nkl.6d9a26kw/b11ddf74a574b13ab04d790ebfd6d643db96eaed.

• identifiant (=DOI): 10.34847/nkl.6d9a26kw

• identfiant du fichier: b11ddf74a574b13ab04d790ebfd6d643db96eaed

• Modification de la taille de l’image (paramètre {taille}) https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/full/200,200/0/default.jpg

• Extraction d’une partie de l’image (paramètre {région})
  https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/250,450,300,300/max/0/default.jpg

• Rotation de l’image (paramètre {rotation})
  https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/full/max/45/default.jpg

• Combinaison d’extraction, de rotation et de redimensionnement de l’image (paramètres [région], {taille} et {rotation})
  https://api.nakala.fr/iiif/11280/111643de/b11ddf74a574b13ab04d790ebfd6d643db96eaed/250,650,400,300/300,300/45/default.jpg

Combinaison de plusieurs paramètres IIIF dans un appel d’image déposée dans NAKALA