API Bible Atlas

Cette API est publique, gratuite et ne nécessite aucune clé API. Bible Atlas l’utilise sur son site web et comme extension sur d’autres plateformes. Son objectif est de simplifier l’intégration des personnes, des lieux, des événements et des visualisations liés à chaque verset biblique dans les applications des développeurs. Conçue pour être simple et intuitive, avec des points d’accès clairs et des réponses cohérentes, l’API permet de créer tout type d’application cliente avec les données nécessaires.

Consultez la documentation complète de l’API. Essayez une requête en direct

Une demande par sélection

Les codes de livre sont les codes à trois lettres USFM . Indiquez plusieurs numéros de versets pour obtenir une réponse unique et sans doublons pour toute une sélection.

GET /api/v1/verse-context?usfm=GEN&chapter=9&verses=8,9

Chaque entité et visualisation est accompagnée de son propre lien de page, d’une image pour une carte et d’un chemin d’intégration prêt pour une iframe.

{
  "reference": "Genesis 9:8-9",
  "entities": [
    {
      "type": "event",
      "name": "God makes a covenant with Noah",
      "href": "/god-makes-a-covenant-with-noah",
      "embed": { "path": "/embed/graph/god-makes-a-covenant-with-noah" }
    },
    { "type": "person", "name": "God", "href": "/god" },
    { "type": "person", "name": "Noah", "href": "/noah" }
  ],
  "visualizations": [
    { "label": "Cross references", "href": "/visualizations/cross-references?ref=Gen.9.8" },
    { "label": "The Noahic Covenant", "href": "/visualizations/covenants#covenant-noahic" }
  ]
}

Générer une carte

Chaque entité et visualisation de la réponse comporte un lien vers une page et une image, soit tout ce dont une carte a besoin.

GET /api/v1/verse-context?usfm=GEN&chapter=9&verses=8,9

<a href="https://bible-atlas.com/noah">
  <img src="https://bible-atlas.com/og/person.png" alt="" />
  <span>Noah</span>
</a>

Noah

The Noahic Covenant

Intégrez directement le verset

Vous pouvez intégrer n’importe quel verset directement dans votre application grâce à une iframe. Il suffit de pointer l’iframe vers l’URL du verset, et Bible Atlas affichera la meilleure intégration disponible pour ce verset. L’intégration remplit automatiquement la largeur de son conteneur et inclut la référence du verset, les entités associées et les visualisations. Vous pouvez également personnaliser l’intégration avec des paramètres de requête, tels que : ?theme=dark pour le mode sombre ou ?height=500 définir une hauteur de 500 pixels.

GET /embed/verse/{book}/{chapter}/{verse}

<iframe src="https://bible-atlas.com/embed/verse/genesis/9/8"></iframe>

yourapp.com/read/genesis/9

Cette iframe, en direct. Genèse 9:8 se résout en un schéma de alliance de Dieu avec Noé.

Ligne de commande

Le paquet bible-atlas encapsule l’API pour les scripts et les agents. Il affiche du JSON, n’exige aucune clé et fonctionne avec Node.js 20 ou version ultérieure. Les erreurs sont envoyées sur stderr sous la forme code: message, avec un code de sortie différent de zéro.

npx bible-atlas verse GEN 9 8