API Bíblia

REST JSON para consultar capítulos, versículos, busca e referências em múltiplas traduções em português. CORS habilitado para apps web e mobile.

Verificando serviço…

Versões disponíveis

  • Carregando…

URL base

/

Use o domínio público (HTTP na porta 80 ou HTTPS na 443). Ex.: https://biblias.chrx.com.br — sem :porta na URL.

Os exemplos abaixo usam o host atual ().

Endpoints

GET /health

Health check para monitoramento.

GET /api/v1/books

Lista canônica dos 66 livros (abreviação, nome, ordem, AT/NT).

GET /api/v1/versions

Lista todas as versões carregadas.

curl "/api/v1/versions"
GET /api/v1/versions/:version

Detalhes de uma versão. Ex.: nvi, acf, ntlh.

GET /api/v1/versions/:version/books

Livros disponíveis na versão, com contagem de capítulos.

GET /api/v1/versions/:version/books/:book

Detalhe do livro. :book aceita abreviação (jo, sl), número (43) ou nome (João).

curl "/api/v1/versions/nvi/books/jo"
GET /api/v1/versions/:version/books/:book/chapters/:chapter

Capítulo completo com todos os versículos.

curl "/api/v1/versions/nvi/books/jo/chapters/3"
GET /api/v1/versions/:version/books/:book/chapters/:chapter/verses/:verse

Um versículo.

curl "/api/v1/versions/nvi/books/jo/chapters/3/verses/16"
GET /api/v1/versions/:version/passage?book=&chapter=&start=&end=

Passagem (intervalo de versículos). end é opcional.

curl "/api/v1/versions/nvi/passage?book=sl&chapter=23&start=1&end=3"
GET /api/v1/versions/:version/reference?ref=

Referência em texto livre: capítulo ou versículo ou intervalo.

curl "/api/v1/versions/nvi/reference?ref=João%203:16"
curl "/api/v1/versions/nvi/reference?ref=Salmos%2023:1-3"
GET /api/v1/versions/:version/search?q=&limit=&offset=

Busca por texto no conteúdo (mínimo 2 caracteres). limit padrão 20.

curl "/api/v1/versions/nvi/search?q=amor&limit=10"
GET /api/v1/versions/:version/random

Versículo aleatório da versão.

Erros

Respostas de erro seguem o formato:

{
  "error": true,
  "code": "VERSION_NOT_FOUND",
  "message": "Versão \"xyz\" não encontrada"
}

Códigos HTTP comuns: 400 parâmetro inválido, 404 não encontrado, 500 erro interno.

Testar API

Clique em "Buscar referência" para testar.