Carregando
Documentação técnica

API Livro dos Sonhos

Consulte letras disponíveis, palavras cadastradas e significados completos do Livro dos Sonhos, com retorno em JSON, autenticação por Bearer Token e controle de requisições no painel.

LI
Versão da documentação 1.0 Maio/2026
Métodos: GET / POST
Autenticação: Bearer Token
Consultas: Letras, lista e palavra
Retorno: JSON
01

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.

Lista de letras Retorna letras de A a Z com total de palavras cadastradas.
Palavras por letra Retorna os sonhos disponíveis para uma letra específica.
Consulta por palavra Retorna milhar, significado e interpretação do sonho.
02

Ferramentas disponíveis no painel

Status da API

Exibe se o módulo está ativo, pausado ou bloqueado administrativamente.

Token Bearer

Permite visualizar, alterar ou gerar novo token para as consultas.

Controle de requisições

Mostra o limite contratado e a quantidade de consultas realizadas.

Histórico de consultas

Registra payloads, IPs, origem, data e retorno das consultas.

Origem da requisição

Salva informações como IP, referer, origin e user-agent quando disponíveis.

Base fixa

O Livro dos Sonhos não depende de datas ou envios automáticos.

03

Início rápido

  1. Copie seu Bearer Token no painel da API Livro dos Sonhos.
  2. Faça uma consulta sem parâmetros para listar letras e quantidades.
  3. Informe uma letra para listar as palavras cadastradas naquela inicial.
  4. Informe uma palavra para receber o significado, milhar e interpretação.
Consulta rápida por palavra
curl -X GET 'https://api.lotoserv.com/sonhos/consulta/v1/?palavra=cavalo' \
  -H 'Authorization: Bearer 275E7ECCD208BF5F9E7C9414'
04

Autenticação

Todas as consultas devem enviar o token no header Authorization usando o formato Bearer.

Header obrigatório
Authorization: Bearer 275E7ECCD208BF5F9E7C9414
Caso o token não seja enviado, esteja em formato incorreto, inválido ou o módulo esteja pausado, a API retornará erro 401.
05

Endpoint

O endpoint aceita requisições GET ou POST. No POST, os dados podem ser enviados como application/json ou formulário comum.

GET / POST https://api.lotoserv.com/sonhos/consulta/v1/
Verificação simples de status
https://api.lotoserv.com/sonhos/consulta/v1/?tipo_conexao=verificar_status
06

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.
Se nenhuma chave for enviada, a API retorna as letras de A a Z com a quantidade de palavras existentes em cada letra.
07

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.
08

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."
        }
    ]
}
09

Erros comuns

401 Token nao fornecido / Token invalido O Bearer Token está ausente, inválido, o módulo está pausado ou bloqueado.
400 Letra inválida / Palavra inválida A letra ou palavra informada não passou na validação.
404 Nenhum registro encontrado Nenhuma palavra ou sonho foi encontrado para a consulta.
405 Método inválido A API aceita apenas GET ou POST.
10

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())
11

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.