Exemplos pequenos e seguros para integrar aplicações à BIBLIAAPI, uma API bíblica em português com contrato OpenAPI.
Este repositório contém somente clientes de exemplo. O código da plataforma, autenticação, cobrança e infraestrutura permanece privado.
- Crie uma conta gratuita em bibliaapi.com.br/conta.
- Gere uma chave de API no painel.
- Exporte a chave antes de executar um exemplo:
export BIBLIA_API_TOKEN="sua_chave"No PowerShell:
$env:BIBLIA_API_TOKEN = "sua_chave"| Linguagem | Arquivo | Execução |
|---|---|---|
| cURL | examples/curl/get-verse.sh |
bash examples/curl/get-verse.sh |
| PHP | examples/php/get-verse.php |
php examples/php/get-verse.php |
| JavaScript | examples/javascript/get-verse.mjs |
node examples/javascript/get-verse.mjs |
Todos consultam João 3:16 na versão ACF usando:
GET /api/v2/versions/acf/books/jo/chapters/3/verses/16
Authorization: Bearer SUA_CHAVE
Os exemplos são intencionalmente pequenos. Eles definem limites de timeout e tratam falhas básicas de transporte/HTTP/payload quando a linguagem permite, mas não implementam retry automático.
Antes de usar o mesmo fluxo em uma aplicação crítica, trate explicitamente transporte, timeout, HTTP não-2xx, parsing do payload, retry/backoff, logs e isolamento da credencial.
O guia Clientes resilientes para APIs HTTP explica um baseline independente de linguagem e um checklist para transformar um exemplo simples em uma integração operacionalmente segura.
Os exemplos podem ser verificados sem fazer uma chamada real à API:
php -l examples/php/get-verse.php
node --check examples/javascript/get-verse.mjs
bash -n examples/curl/get-verse.shO workflow de qualidade permanece disponível para execução manual; o loop normal de manutenção prioriza essas validações locais para evitar consumo desnecessário de CI.
Nunca inclua uma chave real em código, commits, screenshots ou issues. Use variáveis de ambiente e consulte a política de segurança.
Exemplos para outras linguagens e frameworks são bem-vindos. Leia o guia de contribuição e o código de conduta antes de abrir um pull request.
MIT. A licença cobre somente os exemplos deste repositório; dados e serviços consumidos seguem os termos da BIBLIAAPI.