API Bible Atlas

Esta API é pública, gratuita e não requer chave de API. O próprio Bible Atlas utiliza esta API neste site e como extensão em outras plataformas. O objetivo desta API é facilitar aos desenvolvedores a obtenção de informações sobre pessoas, lugares, eventos e visualizações associadas a qualquer versículo bíblico, permitindo que os incorporem em seus próprios aplicativos. A API foi projetada para ser simples e intuitiva, com endpoints claros e respostas consistentes, para que você possa criar qualquer tipo de aplicativo cliente com os dados necessários.

Leia a referência completa da API. Experimente um pedido ao vivo

Um pedido por seleção.

Os códigos de livro são os códigos de três letras do padrão USFM . Informe vários números de versículos para obter uma única resposta, mesclada e sem duplicatas, para toda a seleção.

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

Cada entidade e visualização vem com seu próprio link de página, uma imagem para o cartão e um caminho de incorporação pronto para um 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 um cartão

Cada entidade e visualização na resposta contém um link para a página e uma imagem, que é tudo o que um cartão precisa.

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

Incorpore o versículo diretamente

Você pode incorporar qualquer versículo diretamente em seu aplicativo com um iframe. Basta apontar o iframe para a URL do versículo e o Bible Atlas exibirá a melhor incorporação disponível para esse versículo. A incorporação preenche automaticamente a largura do seu contêiner e inclui a referência do versículo, entidades relacionadas e visualizações. Você também pode personalizar a incorporação com parâmetros de consulta, como ?theme=dark para o modo escuro ou ?height=500 Para definir uma altura 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

Esse iframe está ativo. Gênesis 9:8 resolve-se no gráfico da aliança de Deus com Noé.

Linha de comando

O pacote bible-atlas encapsula a API para scripts e agentes. Ele imprime JSON, não exige chave e roda no Node.js 20 ou mais recente. Os erros vão para o stderr no formato code: message, com um código de saída diferente de zero.

npx bible-atlas verse GEN 9 8