Open data

API publique

Les données structurées du corpus, accessibles en JSON sous licence CC BY-SA 4.0. Aucune authentification, aucun coût, aucun traceur.

Endpoints: 9
Entrées totales: 198
Licence: CC BY-SA 4.0

Endpoints

Neuf jeux de données

/api/manuscripts.json 69 entrées

Catalogue raisonné : métadonnées codicologiques, provenance, cross-refs.
/api/people.json 35 entrées

Personnes : dates, rôles, lieux, famille, mentors, disciples, œuvres.
/api/families.json 12 entrées

Lignées rabbiniques : variantes, origine, parcours, membres.
/api/communities.json 12 entrées

Communautés-mères : période, fondateur, familles, manuscrits.
/api/stories.json 13 entrées

Récits grand public — corps Markdown intégral.
/api/glossary.json 17 entrées

Termes-clés du judaïsme maghrébin médiéval.
/api/places.json 26 entrées

Géolocalisation des villes et institutions ([lng, lat]).
/api/trajectories.json 4 entrées

Trajets historiques en GeoJSON LineString.
/api/milestones.json 10 entrées

Avancement du projet : phases, compteurs, jalons.

Le catalogue complet des endpoints est aussi accessible programmatiquement : /api/index.json.

Format

Schéma de réponse standard

Toutes les réponses suivent le même schéma : un bloc meta (métadonnées, licence, source) et un bloc data (le contenu).

{
  "meta": {
    "apiVersion": "1",
    "collection": "manuscripts",
    "total": 69,
    "license": "CC BY-SA 4.0",
    "licenseUrl": "https://creativecommons.org/licenses/by-sa/4.0/",
    "attribution": "Collectif GMPL — MMJMM",
    "source": "https://mmjmm.org/api/manuscripts.json",
    "generated": "2026-06-03T12:02:02.760Z"
  },
  "data": [
    {
      "id": "bodleian-opp-add-4-84",
      "title": "Maḥzor d'Oran — Volume I",
      "author": "anonyme (compilation Cansino, attribution probable)",
      "date": { "from": 1600, "to": 1669, "precision": "century" },
      "origin": { "city": "Oran", "region": "présidio espagnol", "country": "Algérie" },
      "language": ["hebrew", "judeo-arabic"],
      "script": "maghrebi",
      "currentLocation": {
        "institution": "Bodleian Library",
        "city": "Oxford",
        "country": "Royaume-Uni",
        "shelfmark": "MS. Opp. Add. 4° 84",
        "iiifManifest": null
      },
      "isFromLuzzattoFonds": true,
      "status": "identified",
      "url": "https://mmjmm.org/corpus/catalogue/bodleian-opp-add-4-84",
      "body": "## Description\n\nPremier volume du *Maḥzor d'Oran*…"
      // … autres champs
    }
    // … autres entrées
  ]
}

Exemple

Récupérer le catalogue depuis JavaScript

// Récupérer les fiches manuscrit
const res = await fetch('https://mmjmm.org/api/manuscripts.json');
const { meta, data } = await res.json();

console.log(`${meta.total} fiches sous licence ${meta.license}`);
for (const ms of data) {
  console.log(ms.title, '—', ms.currentLocation.shelfmark);
}

Les endpoints sont des fichiers statiques générés à chaque build du site. Pas d'authentification, pas de rate limit côté API, pas de pagination (le corpus est petit — la plus grosse réponse est /api/stories.json à environ 100 Ko).

Conditions d’usage

Ce qui est permis

Toutes les données de l'API sont publiées sous licence Creative Commons BY-SA 4.0. Vous pouvez les réutiliser, les modifier, les redistribuer, et les inclure dans des œuvres dérivées — y compris commerciales — à deux conditions :

Attribution : citer « Collectif GMPL — MMJMM » et inclure un lien vers mmjmm.org.
Partage à l'identique : les œuvres dérivées doivent être distribuées sous la même licence CC BY-SA 4.0.

Exception : les images de manuscrits auxquelles l'API fait référence restent la propriété des institutions détentrices (Bodleian, AIU, NLI…). Leur réutilisation est soumise aux conditions de chaque institution.

Vous utilisez ces données ?

Faites-le-nous savoir.

Le collectif est preneur de retours d'usage — pour la prochaine version du schéma, pour les besoins manquants, pour les collaborations possibles autour des données.

recherche@mmjmm.org