API Bible Atlas

Esta API es pública, gratuita y no requiere clave. Bible Atlas la utiliza en este sitio web y como extensión en otras plataformas. Su objetivo es facilitar a los desarrolladores el acceso a personas, lugares, eventos y visualizaciones relacionados con cualquier versículo bíblico, e integrarlos en sus propias aplicaciones. La API está diseñada para ser sencilla e intuitiva, con puntos de acceso claros y respuestas consistentes, lo que permite crear cualquier tipo de aplicación cliente con los datos necesarios.

Lea la referencia completa de la API. Pruebe con una solicitud en vivo

Una solicitud por selección

Los códigos de los libros son de tres letras. USFM códigos. Introduzca varios números de versículos para obtener una respuesta combinada y sin duplicados para toda la selección.

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

Cada entidad y visualización incluye su propio enlace de página, una imagen para una tarjeta y una ruta de inserción lista para un 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" }
  ]
}

Renderizar una tarjeta

Cada entidad y visualización en la respuesta incluye un enlace a una página y una imagen, que es todo lo que necesita una tarjeta.

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

Inserte el versículo directamente

Puede insertar cualquier versículo directamente en su aplicación con un iframe. Simplemente apunta el iframe a la URL del versículo y Bible Atlas mostrará la mejor inserción disponible para ese versículo. La inserción ocupa automáticamente todo el ancho de su contenedor e incluye la referencia del versículo, entidades relacionadas y visualizaciones. También puede personalizar la inserción con parámetros de consulta, como ?theme=dark para el modo oscuro o ?height=500 para establecer una altura de 500 píxeles.

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

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

yourapp.com/read/genesis/9

Ese iframe, en vivo. Génesis 9:8 se resuelve en el gráfico del pacto de Dios con Noé.

Línea de comandos

El bible-atlas El paquete encapsula la API para scripts y agentes. Imprime JSON, no necesita clave y se ejecuta en Node.js 20 o posterior. Los errores van a stderr como code: message, con un código de salida distinto de cero.

npx bible-atlas verse GEN 9 8