Documentação da API

Acesse dados em tempo real das Loterias Caixa através de nossa API RESTful. Respostas rápidas, estruturadas e prontas para integração.

Alta Performance

Cache inteligente e baixa latência.

Dados Oficiais

Sincronização direta com a Caixa.

Acesso Livre

API aberta para desenvolvedores.

URL Base

Todas as requisições devem apontar para a raiz da nossa API:

http://loterias.eletroinfo.site/api.php

Acesso e Regras

Autenticação: Atualmente a API é pública e não exige chaves de acesso.
CORS: Totalmente habilitado para chamadas diretas via Client-side (JavaScript).
Limites: Recomendamos o uso de cache local para evitar requisições redundantes.

Endpoints

GET /api.php

Consulta principal de resultados. Use os parâmetros para filtrar.

Parâmetros da Query

Campo	Tipo	Descrição
`loteria`	string	Slug (ex: `megasena`, `quina`, `lotofacil`)
`concurso`	int	Número do sorteio específico.
`limit`	int	Quantidade (Padrão: 1, Máx: 50).

Estrutura da Resposta

O retorno é um objeto JSON padronizado para facilitar o parsing.

RESPOSTA JSON 200 OK

{
  "status": "success",
  "total_retornado": 1,
  "dados": [
    {
      "loteria": "megasena",
      "concurso": 2500,
      "data": "2023-05-20",
      "acumulou": true,
      "dezenas": ["10", "15", "22", "35", "40", "59"],
      "proximo_concurso": {
        "numero": 2501,
        "data": "2023-05-24",
        "estimativa_premio": 45000000.00
      }
    }
  ]
}

Exemplos de Uso

JavaScript (Fetch)

Chamada assíncrona padrão para navegadores modernos:

fetch('http://loterias.eletroinfo.site/api.php?loteria=megasena')
  .then(res => res.json())
  .then(json => console.log(json.dados[0]));

jQuery

Ideal para projetos que utilizam a biblioteca jQuery:

$.getJSON('http://loterias.eletroinfo.site/api.php', { loteria: 'lotofacil' }, function(data) {
  console.log('Último concurso:', data.dados[0].concurso);
});

Python (Requests)

Exemplo para automações e ciência de dados:

import requests

url = "http://loterias.eletroinfo.site/api.php"
params = {"loteria": "megasena", "limit": 1}
response = requests.get(url, params=params)
data = response.json()

print(data['dados'][0]['dezenas'])

Node.js (Axios)

Utilizando a biblioteca Axios para chamadas backend:

const axios = require('axios');

axios.get('http://loterias.eletroinfo.site/api.php', { params: { loteria: 'quina' } })
  .then(res => console.log(res.data.dados[0]))
  .catch(err => console.error(err));

PHP (Backend)

Exemplo simples utilizando file_get_contents:

$url = "http://loterias.eletroinfo.site/api.php?loteria=quina";
$response = file_get_contents($url);
$data = json_decode($response, true);