Ref@ire Lachèvre...

API du projet Recueils 17

L’API est disponible à l’adresse https://recueils17.othone.org/api

Elle permet de consulter, en lecture seule, les pièces poétiques, auteurs et recueils imprimés du corpus Ref@ire Lachèvre, ainsi que d'utiliser un moteur de recherche transversale.

Pour éviter l’exploitation massive par des modèles de type LLM, l’accès est restreint par clé API.
Pour obtenir une clé, écrivez à : contact@othone.org en précisant brièvement votre institution et votre projet).

Endpoints disponibles

Documentation YAML

1. /pieces
Retourne la liste des pièces poétiques, avec possibilité de filtrer par forme, auteur ou recueil.
Exemple :
https://recueils17.othone.org/api/pieces?forme=V&auteur=corneille&limit=5
Paramètres : forme, auteur, recueil, limit, offset.

2. /auteurs
Liste des auteurs présents dans la base, avec recherche textuelle et pagination.
Exemple :
https://recueils17.othone.org/api/auteurs?q=La+Fontaine&limit=10
Paramètres : q, limit, offset.

3. /recueils
Permet d’explorer les recueils imprimés selon la ville, l’année ou le titre.
Exemple :
https://recueils17.othone.org/api/recueils?ville=Rouen&annee=1660
Paramètres : ville, annee, q, limit, offset.

4. /search
Effectue une recherche transversale dans les pièces, auteurs et recueils (texte libre, citations, filtres combinés).
Exemple :
https://recueils17.othone.org/api/search?q="Beauté+qui+ne+vivez"+Rouen&scope=pieces&annee_min=1590&annee_max=1600
Paramètres : q, scope, forme, ville, annee_min, annee_max, auteur_id, recueil_id, limit, offset.

Format de réponse
Les réponses sont au format JSON :
{"data": [...], "meta": {"limit":10, "offset":0, "count":10}}
En cas d’erreur, un code HTTP explicite est renvoyé (401, 404, 429, 500) avec un message du type :
{"error":"invalid_api_key"}