Documentação completa para integrar os Salmos em suas aplicações
Versão 1.0.0A API REST dos Salmos permite acesso gratuito aos 150 Salmos da Bíblia em português e hebraico. A API é baseada em REST e retorna dados em formato JSON.
| Header | Descrição | Exemplo |
|---|---|---|
X-RateLimit-Limit |
Limite total de requisições | 5 |
X-RateLimit-Remaining |
Requisições restantes | 4 |
X-RateLimit-Reset |
Timestamp para reset | 1705320000 |
A API não requer autenticação. Todas as requisições podem ser feitas diretamente via GET sem necessidade de tokens ou chaves de API.
Obtém um salmo específico pelo número.
id (obrigatório): Número do salmo (1-150)lingua (opcional): pt ou heb (padrão: pt)Lista salmos com paginação.
page (opcional): Número da página (padrão: 1)per_page (opcional): Itens por página (máx. 50, padrão: 10)lingua (opcional): pt ou hebBusca salmos por texto.
termo (obrigatório): Texto para buscarlingua (opcional): pt ou hebObtém um salmo aleatório.
Obtém estatísticas dos salmos.
| Parâmetro | Tipo | Descrição | Valores Válidos | Padrão |
|---|---|---|---|---|
lingua |
string | Idioma do salmo | pt, heb |
pt |
page |
integer | Número da página | 1 até total de páginas | 1 |
per_page |
integer | Itens por página | 1 até 50 | 10 |
termo |
string | Termo para busca | Qualquer texto | - |
// Obter Salmo 23 em português
fetch('https://ferramentasdaweb.com.br/db/salmos/api/salmos/23?lingua=pt')
.then(response => response.json())
.then(data => {
console.log('Salmo:', data.data.numero);
console.log('Texto:', data.data.texto);
})
.catch(error => console.error('Erro:', error));
<?php
// Obter Salmo 91 em hebraico
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://ferramentasdaweb.com.br/db/salmos/api/salmos/91?lingua=heb',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSL_VERIFYPEER => false
]);
$response = curl_exec($curl);
$data = json_decode($response, true);
curl_close($curl);
if ($data['success']) {
echo $data['data']['texto'];
}
import requests
# Buscar salmos com a palavra "amor"
response = requests.get(
'https://ferramentasdaweb.com.br/db/salmos/api/busca',
params={'termo': 'amor', 'lingua': 'pt'}
)
data = response.json()
if data['success']:
for salmo in data['data']:
print(f"Salmo {salmo['numero']}")
print(salmo['texto'][:100])
print()
const axios = require('axios');
// Obter salmo aleatório
async function getSalmoAleatorio() {
try {
const response = await axios.get(
'https://ferramentasdaweb.com.br/db/salmos/api/random',
{ params: { lingua: 'pt' } }
);
console.log('Salmo:', response.data.data.numero);
console.log('Texto:', response.data.data.texto);
} catch (error) {
console.error('Erro:', error.message);
}
}
getSalmoAleatorio();
// Listar salmos com paginação
$.ajax({
url: 'https://ferramentasdaweb.com.br/db/salmos/api/salmos',
method: 'GET',
data: {
page: 1,
per_page: 5,
lingua: 'pt'
},
success: function(response) {
response.data.forEach(function(salmo) {
console.log('Salmo ' + salmo.numero + ':');
console.log(salmo.texto.substring(0, 100) + '...');
});
},
error: function(xhr, status, error) {
console.error('Erro:', error);
}
});
{
"success": true,
"data": {
"numero": 23,
"texto": "1 O Senhor é meu pastor, nada me faltará...",
"lingua": "pt",
"versiculos": [
{
"numero": 1,
"texto": "O Senhor é meu pastor, nada me faltará"
},
{
"numero": 2,
"texto": "Deitar-me faz em verdes pastos..."
}
],
"links": {
"self": "https://ferramentasdaweb.com.br/db/salmos/api/salmos/23?lingua=pt",
"anterior": "https://ferramentasdaweb.com.br/db/salmos/api/salmos/22?lingua=pt",
"proximo": "https://ferramentasdaweb.com.br/db/salmos/api/salmos/24?lingua=pt",
"web": "https://ferramentasdaweb.com.br/db/salmos/index.php?salmo=23&lingua=pt"
}
},
"rate_limit": {
"limit": 5,
"remaining": 4,
"reset_in_seconds": 3600
}
}
{
"success": false,
"error": {
"code": 429,
"message": "Limite de requisições excedido. Tente novamente mais tarde.",
"rate_limit": {
"limit": 5,
"remaining": 0,
"reset_in_seconds": 1800,
"reset_at": "2024-01-15 14:30:00"
}
}
}
| Código | Descrição | Causa Comum |
|---|---|---|
| 200 | Sucesso | Requisição processada com sucesso |
| 400 | Parâmetros inválidos | Número do salmo fora do range, termo de busca vazio |
| 404 | Recurso não encontrado | Salmo não existe, endpoint inválido |
| 405 | Método não permitido | Usando POST, PUT, DELETE (apenas GET é permitido) |
| 429 | Limite excedido | Muitas requisições em pouco tempo |
Use o formulário abaixo para testar a API diretamente: