Bible · API publique

Un verset,
sans quitter la lecture.

Le module reconnaît les références bibliques dans une page et affiche le texte après un court délai au survol — immédiatement au clavier ou au toucher.

Installer le module Voir la réponse JSON

Endpoint actif · JSON UTF-8 · 20 versets maximum

Démonstration réelle

Survolez une référence.

Attendez une demi-seconde avec la souris, ou placez directement le focus au clavier.

« Car Dieu a tant aimé le monde… » — Jean 3.16

La foi vient de ce qu’on entend : Romains 10.17.

Une plage fonctionne aussi : Psaumes 23.1–3.

01 · Deux lignes suffisent

Installation

Ajoutez le module à la fin de votre page. Il charge lui-même sa feuille de style et analyse les zones de contenu compatibles.

<script type="module" src="https://www.gospelmag.fr/assets/js/crossref.js"></script>

La version Semeur est utilisée par défaut. Le module s’appuie sur http.js pour les requêtes et la gestion des erreurs.

02 · Requête HTTP

Endpoint JSON

Une requête GET retourne la référence normalisée, la traduction, le livre, les versets, les notes, les variantes textuelles éventuelles et l’URL de lecture.

GET /api/versets?livre=Jean&chapitre=3&verset=16&version=SEM
{
  "reference": "Jean 3.16",
  "translation": { "code": "SEM" },
  "chapter": 3,
  "verses": [{
    "number": 16,
    "text": "…",
    "variants": []
  }],
  "url": "/bible/SEM/jean/3#v16"
}

03 · Contrat

Paramètres

livre
Nom ou abréviation française : Jean, Jn, 1Co…
requis
chapitre
Numéro du chapitre demandé.
requis
verset
Premier verset de la sélection.
requis
fin
Dernier verset, avec une plage maximale de vingt versets.
facultatif
version
Code d’une traduction active. SEM par défaut.
facultatif

Personnalisation

Délai et traduction

Le délai par défaut est de 500 ms. Configurez le module avant son chargement ; l’accès clavier reste immédiat.

<script>
window.GospelMagCrossRef = {
  hoverDelay: 700,
  apiBase: "https://www.gospelmag.fr"
};
</script>

La traduction peut aussi être définie sur l’élément <html> avec data-bible-crossref-version="SEM".

04 · Tester sans coder

Collection Postman prête à importer.

La collection vérifie un verset simple, une plage, une abréviation et une réponse d’erreur. Importez ensuite l’environnement local.

Apparence