Carregando
Documentação técnica

API de Horóscopo Diário

Consulte previsões diárias dos 12 signos por requisição HTTP, com autenticação Bearer Token, retorno em JSON, histórico de consultas e controle de limite pelo painel da Loteria Integrada.

Versão da documentação 2.0 Maio/2026
Método: GET ou POST
Autenticação: Bearer Token
Referência: Previsão do dia
Retorno: 12 signos
01

Visão geral

A API de Horóscopo é uma API de consulta. O seu site/app deve realizar uma requisição para um dos nossos endpoints sempre que desejar obter as previsões do dia.

Consulta sob demandaO usuário chama o endpoint quando quiser obter o horóscopo atualizado.
Previsão diáriaO retorno usa a data de referência atual do servidor e contempla os 12 signos.
Controle de consumoCada consulta válida atualiza o contador e o histórico do painel.
02

Ferramentas disponíveis no painel

Contador de requisições

Exibe o total consumido e o limite disponível para o módulo contratado.

Última requisição

Mostra a data e hora da última consulta feita pelo site/app.

Pausar ou retomar

Permite desativar temporariamente as consultas da API.

Rota atual

Exibe o endpoint configurado para uso na integração.

Token Bearer

Permite visualizar, alterar ou gerar um novo token de autenticação.

Histórico e payloads

Lista consultas realizadas e permite visualizar o JSON retornado.

Visualizar horóscopo

Permite conferir as previsões salvas no painel antes de usar no site/app.

Status do endpoint

Valida se a rota está acessível e respondendo corretamente.

03

Início rápido

  1. Copie o endpoint exibido no painel da API de Horóscopo.
  2. Copie o token Bearer do painel e mantenha-o protegido no backend do seu sistema.
  3. Faça uma requisição GET ou POST para o endpoint usando o cabeçalho Authorization: Bearer SEU_TOKEN.
  4. Leia o array dados da resposta JSON para exibir previsão, dezenas e cores por signo.
Evite expor o token diretamente em aplicativos públicos ou JavaScript de frontend. Quando possível, consulte a API pelo backend do seu site/app.
04

Autenticação

Toda consulta deve enviar o token no cabeçalho Authorization, no formato Bearer. Requisições sem token, com token inválido ou em formato incorreto serão recusadas.

Header obrigatório
Accept: application/json
Authorization: Bearer 396637E250B0FE02BDD6162A
05

Como consultar

O endpoint aceita GET e POST. Em POST, também aceita corpo JSON, form-data ou x-www-form-urlencoded. Atualmente, a previsão retornada é a previsão diária da data de referência do servidor.

GET recomendadohttps://api.lotoserv.com/horoscopo/v1/Mais simples para consumo e cache do seu sistema.
POST compatívelContent-Type: application/jsonDisponível para sistemas que padronizam integrações via POST.
06

Resposta JSON

Quando a consulta é autorizada e há previsões cadastradas para o dia, a API retorna HTTP 200 com os dados do usuário, informações da consulta e a lista de previsões.

CampoDescrição
usuario.terminalIdentificador do terminal vinculado ao usuário.
usuario.site_appNome do site/app cadastrado no painel.
consulta.numeroNúmero atual de consultas consumidas pelo usuário.
consulta.dataData e hora da consulta no formato brasileiro.
consulta.ipIP de origem da requisição.
informacoes.tipo_apiTipo da API retornada, neste caso Horóscopo Diário.
informacoes.data_referenciaData de referência das previsões no formato YYYY-mm-dd.
informacoes.total_registrosTotal de previsões retornadas.
dados[].signoNome do signo.
dados[].previsaoTexto da previsão diária.
dados[].dezenasDezenas ou números da sorte vinculados ao signo.
dados[].coresCores indicadas para o signo.
Exemplo de resposta
{
    "usuario": {
        "terminal": "6715",
        "site_app": "Meu Site/App"
    },
    "consulta": {
        "numero": "128",
        "data": "14/06/2026 02:14:10",
        "ip": "189.00.00.00"
    },
    "informacoes": {
        "tipo_api": "Horóscopo Diario",
        "data_referencia": "2026-06-14",
        "total_registros": 12
    },
    "dados": [
        {
            "signo": "Áries",
            "previsao": "Hoje é um bom dia para agir com confiança, mas sem pressa. Observe oportunidades e evite decisões impulsivas.",
            "dezenas": "04, 18, 29",
            "cores": "Vermelho, Branco"
        },
        {
            "signo": "Touro",
            "previsao": "Organização e paciência ajudam a resolver pendências. Valorize conversas objetivas e escolhas práticas.",
            "dezenas": "07, 21, 36",
            "cores": "Verde, Bege"
        }
    ]
}
07

Signos retornados

O retorno padrão contempla os 12 signos. A ordem pode variar de acordo com o cadastro interno, então recomendamos localizar o signo pelo campo signo, e não pela posição no array.

Áries
Touro
Gêmeos
Câncer
Leão
Virgem
Libra
Escorpião
Sagitário
Capricórnio
Aquário
Peixes
08

Erros, limites e respostas

401Token inválido/ausenteO token não foi enviado, está incorreto ou fora do formato Bearer.
401Limite atingidoO módulo atingiu o limite de requisições contratado.
401Sem previsãoAinda não existem previsões registradas para a data de referência.
{
    "status": "error",
    "code": "401",
    "message": "Token nao fornecido"
}
{
    "status": "error",
    "code": "401",
    "message": "Seu módulo atingiu o limite de 10000 requisições diárias."
}
{
    "status": "error",
    "code": "401",
    "message": "Ainda não há previsões registradas para 14/06/2026"
}
09

Exemplos por linguagem

Use os exemplos abaixo para consultar o horóscopo do dia. Troque o endpoint e o token pelos dados exibidos no painel do usuário.

curl -X GET 'https://api.lotoserv.com/horoscopo/v1/' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL'
<?php
header('Content-Type: text/html; charset=utf-8');

$endpoint = 'https://api.lotoserv.com/horoscopo/v1/';
$token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL';

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_CUSTOMREQUEST => 'GET',
	CURLOPT_TIMEOUT => 20,
	CURLOPT_HTTPHEADER => [
		'Accept: application/json',
		'Authorization: Bearer '.$token
	]
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$erroCurl = curl_error($ch);
curl_close($ch);

if ($erroCurl) {
	die('Erro de conexão: '.$erroCurl);
}

$dados = json_decode($response, true);

if ($httpCode !== 200 || !is_array($dados)) {
	echo '<pre>Erro na consulta: '.htmlspecialchars($response).'</pre>';
	exit;
}

foreach ($dados['dados'] as $signo) {
	echo '<h3>'.htmlspecialchars($signo['signo']).'</h3>';
	echo '<p>'.htmlspecialchars($signo['previsao']).'</p>';
	echo '<p><b>Dezenas:</b> '.htmlspecialchars($signo['dezenas']).'</p>';
	echo '<p><b>Cores:</b> '.htmlspecialchars($signo['cores']).'</p>';
	echo '<hr>';
}
const endpoint = 'https://api.lotoserv.com/horoscopo/v1/';
const token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL';

async function consultarHoroscopo() {
  const resposta = await fetch(endpoint, {
    method: 'GET',
    headers: {
      'Accept': 'application/json',
      'Authorization': `Bearer ${token}`
    }
  });

  const dados = await resposta.json();

  if (!resposta.ok) {
    console.error('Erro na consulta:', dados);
    return;
  }

  dados.dados.forEach((signo) => {
    console.log(signo.signo, signo.previsao, signo.dezenas, signo.cores);
  });
}

consultarHoroscopo();
const endpoint = 'https://api.lotoserv.com/horoscopo/v1/';
const token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL';

async function consultarHoroscopo() {
  const resposta = await fetch(endpoint, {
    method: 'GET',
    headers: {
      'Accept': 'application/json',
      'Authorization': `Bearer ${token}`
    }
  });

  const dados = await resposta.json();

  if (!resposta.ok) {
    console.error('Erro na consulta:', dados);
    return;
  }

  console.log('Data referência:', dados.informacoes.data_referencia);
  console.log('Total de signos:', dados.informacoes.total_registros);

  for (const item of dados.dados) {
    console.log(`${item.signo}: ${item.previsao}`);
    console.log(`Dezenas: ${item.dezenas} | Cores: ${item.cores}`);
  }
}

consultarHoroscopo();
import requests

endpoint = 'https://api.lotoserv.com/horoscopo/v1/'
token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL'

headers = {
    'Accept': 'application/json',
    'Authorization': f'Bearer {token}'
}

resposta = requests.get(endpoint, headers=headers, timeout=20)

dados = resposta.json()

if resposta.status_code != 200:
    print('Erro na consulta:', dados)
    exit()

print('Data referência:', dados['informacoes']['data_referencia'])
print('Total de signos:', dados['informacoes']['total_registros'])

for signo in dados['dados']:
    print(signo['signo'])
    print(signo['previsao'])
    print('Dezenas:', signo['dezenas'])
    print('Cores:', signo['cores'])
    print('-' * 30)
using System.Net.Http.Headers;
using System.Text.Json;

var endpoint = "https://api.lotoserv.com/horoscopo/v1/";
var token = "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL";

using var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

var response = await client.GetAsync(endpoint);
var body = await response.Content.ReadAsStringAsync();

if (!response.IsSuccessStatusCode)
{
    Console.WriteLine("Erro na consulta:");
    Console.WriteLine(body);
    return;
}

using var json = JsonDocument.Parse(body);
var root = json.RootElement;

Console.WriteLine("Data referência: " + root.GetProperty("informacoes").GetProperty("data_referencia").GetString());

foreach (var signo in root.GetProperty("dados").EnumerateArray())
{
    Console.WriteLine(signo.GetProperty("signo").GetString());
    Console.WriteLine(signo.GetProperty("previsao").GetString());
    Console.WriteLine("Dezenas: " + signo.GetProperty("dezenas").GetString());
    Console.WriteLine("Cores: " + signo.GetProperty("cores").GetString());
}
package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"time"
)

func main() {
	endpoint := "https://api.lotoserv.com/horoscopo/v1/"
	token := "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL"

	client := &http.Client{Timeout: 20 * time.Second}

	req, err := http.NewRequest("GET", endpoint, nil)
	if err != nil {
		panic(err)
	}

	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer "+token)

	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)

	if resp.StatusCode != 200 {
		fmt.Println("Erro na consulta:", string(body))
		return
	}

	var dados map[string]interface{}
	json.Unmarshal(body, &dados)

	fmt.Println("Resposta:", dados)
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ConsultaHoroscopo {
    public static void main(String[] args) throws Exception {
        String endpoint = "https://api.lotoserv.com/horoscopo/v1/";
        String token = "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL";

        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(endpoint))
                .GET()
                .header("Accept", "application/json")
                .header("Authorization", "Bearer " + token)
                .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        if (response.statusCode() != 200) {
            System.out.println("Erro na consulta:");
            System.out.println(response.body());
            return;
        }

        System.out.println(response.body());
    }
}
curl -X POST 'https://api.lotoserv.com/horoscopo/v1/' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL' \
  -d '{}'