Visão geral
A API Livro dos Sonhos permite consultar um banco fixo de sonhos e interpretações. O cliente pode listar as letras disponíveis, buscar todas as palavras de uma letra ou consultar diretamente uma palavra específica.
Ferramentas disponíveis no painel
Exibe se o módulo está ativo, pausado ou bloqueado administrativamente.
Permite visualizar, alterar ou gerar novo token para as consultas.
Mostra o limite contratado e a quantidade de consultas realizadas.
Registra payloads, IPs, origem, data e retorno das consultas.
Salva informações como IP, referer, origin e user-agent quando disponíveis.
O Livro dos Sonhos não depende de datas ou envios automáticos.
Início rápido
- Copie seu Bearer Token no painel da API Livro dos Sonhos.
- Faça uma consulta sem parâmetros para listar letras e quantidades.
- Informe uma letra para listar as palavras cadastradas naquela inicial.
- Informe uma palavra para receber o significado, milhar e interpretação.
curl -X GET 'https://api.lotoserv.com/sonhos/consulta/v1/?palavra=cavalo' \
-H 'Authorization: Bearer 275E7ECCD208BF5F9E7C9414'
Autenticação
Todas as consultas devem enviar o token no header Authorization usando o formato Bearer.
Authorization: Bearer 275E7ECCD208BF5F9E7C9414
401.
Endpoint
O endpoint aceita requisições GET ou POST. No POST, os dados podem ser enviados como application/json ou formulário comum.
https://api.lotoserv.com/sonhos/consulta/v1/
https://api.lotoserv.com/sonhos/consulta/v1/?tipo_conexao=verificar_status
Parâmetros da consulta
| Parâmetro | Obrigatório | Exemplo | Descrição |
|---|---|---|---|
letra |
Não | c |
Retorna a lista de palavras cadastradas com a letra informada. |
palavra |
Não | cavalo |
Retorna as informações completas do sonho pesquisado. |
A a Z com a quantidade de palavras existentes em cada letra.
Tipos de consulta
| Consulta | Como chamar | Retorno |
|---|---|---|
| Letras disponíveis | Sem parâmetros | Lista de letras de A a Z com total_palavras. |
| Palavras por letra | ?letra=c |
Lista simples com os sonhos cadastrados naquela letra. |
| Consulta por palavra | ?palavra=cavalo |
Objeto com sonho, letra, milhar, significado e significado2. |
Resposta JSON
O retorno é dividido em blocos principais: usuario, consulta, informacoes e dados.
{
"usuario": {
"terminal": "123456",
"site_app": "Meu Site"
},
"consulta": {
"numero": 1,
"data": "11/06/2026 15:52:35",
"ip": "000.000.000.000"
},
"informacoes": {
"tipo_api": "Livro dos Sonhos",
"tipo_consulta": "letras",
"letra": "",
"palavra": "",
"total_registros": 26
},
"dados": [
{
"letra": "a",
"total_palavras": 120
},
{
"letra": "b",
"total_palavras": 95
},
{
"letra": "c",
"total_palavras": 140
}
]
}
{
"usuario": {
"terminal": "123456",
"site_app": "Meu Site"
},
"consulta": {
"numero": 2,
"data": "11/06/2026 15:52:35",
"ip": "000.000.000.000"
},
"informacoes": {
"tipo_api": "Livro dos Sonhos",
"tipo_consulta": "letra",
"letra": "c",
"palavra": "",
"total_registros": 3
},
"dados": [
"Cachorro",
"Casa",
"Cavalo"
]
}
{
"usuario": {
"terminal": "123456",
"site_app": "Meu Site"
},
"consulta": {
"numero": 3,
"data": "11/06/2026 15:52:35",
"ip": "000.000.000.000"
},
"informacoes": {
"tipo_api": "Livro dos Sonhos",
"tipo_consulta": "palavra",
"letra": "",
"palavra": "cavalo",
"total_registros": 1
},
"dados": [
{
"id": 123,
"sonho": "Cavalo",
"letra": "c",
"milhar": "1111,2222,3333",
"significado": "Exemplo de significado do sonho.",
"significado2": "Exemplo de interpretação complementar."
}
]
}
Erros comuns
Token nao fornecido / Token invalido
O Bearer Token está ausente, inválido, o módulo está pausado ou bloqueado.
Letra inválida / Palavra inválida
A letra ou palavra informada não passou na validação.
Nenhum registro encontrado
Nenhuma palavra ou sonho foi encontrado para a consulta.
Método inválido
A API aceita apenas GET ou POST.
Exemplos de uso
curl -X GET 'https://api.lotoserv.com/sonhos/consulta/v1/' \
-H 'Authorization: Bearer 275E7ECCD208BF5F9E7C9414'
curl -X GET 'https://api.lotoserv.com/sonhos/consulta/v1/?letra=c' \
-H 'Authorization: Bearer 275E7ECCD208BF5F9E7C9414'
curl -X GET 'https://api.lotoserv.com/sonhos/consulta/v1/?palavra=cavalo' \
-H 'Authorization: Bearer 275E7ECCD208BF5F9E7C9414'
curl -X POST 'https://api.lotoserv.com/sonhos/consulta/v1/' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer 275E7ECCD208BF5F9E7C9414' \
-d '{
"palavra": "cavalo"
}'
<?php
$endpoint = 'https://api.lotoserv.com/sonhos/consulta/v1/';
$token = '275E7ECCD208BF5F9E7C9414';
$params = [
'palavra' => 'cavalo'
];
$url = $endpoint . '?' . http_build_query($params);
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPGET => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Accept: application/json'
],
CURLOPT_TIMEOUT => 30
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$erro = curl_error($ch);
curl_close($ch);
if($erro){
die('Erro cURL: ' . $erro);
}
$dados = json_decode($response, true);
if($httpCode != 200){
echo 'Erro na consulta: ';
print_r($dados);
exit;
}
print_r($dados['dados']);
const axios = require('axios');
const endpoint = 'https://api.lotoserv.com/sonhos/consulta/v1/';
const token = '275E7ECCD208BF5F9E7C9414';
async function consultarSonho() {
try {
const response = await axios.get(endpoint, {
headers: {
Authorization: `Bearer ${token}`,
Accept: 'application/json'
},
params: {
palavra: 'cavalo'
}
});
console.log(response.data.dados);
} catch (error) {
console.error(error.response?.data || error.message);
}
}
consultarSonho();
import requests
endpoint = 'https://api.lotoserv.com/sonhos/consulta/v1/'
token = '275E7ECCD208BF5F9E7C9414'
params = {
'palavra': 'cavalo'
}
headers = {
'Authorization': f'Bearer {token}',
'Accept': 'application/json'
}
response = requests.get(endpoint, params=params, headers=headers, timeout=30)
print(response.status_code)
print(response.json())
Observações importantes
- Quando nenhuma chave é enviada, a API retorna a lista de letras disponíveis.
- Quando a chave
letraé enviada, a API retorna somente as palavras daquela letra. - Quando a chave
palavraé enviada, a API retorna o significado completo do sonho. - A consulta por palavra exige pelo menos 2 caracteres.
- O limite de requisições é controlado pelo plano contratado.
- As consultas são registradas com IP, origem, user-agent e payload quando disponíveis.