loterias-api

loterias-api copied to clipboard

API Loterias CAIXA

API Gratuita de resultado de jogos das Loterias CAIXA.
Espero melhorar a API com o tempo. Por enquanto, as mudanças nem sempre serão compatíveis com versões anteriores.

Exemplos de Retorno

Atualmente o banco de dados contém os jogos das loterias ...

https://loteriascaixa-api.herokuapp.com/api

[
  "mega-sena",
  "lotofacil",
  "quina",
  "lotomania",
  "timemania",
  "dupla-sena",
  "loteria-federal",
  "dia-de-sorte",
  "super-sete"
]

• Resultado mais Recente

https://loteriascaixa-api.herokuapp.com/api/<loteria>/latest

Por exemplo da Mega Sena, em:

https://loteriascaixa-api.herokuapp.com/api/mega-sena/latest

{
  "loteria": "mega-sena",
  "nome": "Mega-Sena",
  "concurso": 2431,
  "data": "24/11/2021",
  "local": "ESPAÇO LOTERIAS CAIXA em SÃO PAULO, SP",
  "dezenas": [
    "08",
    "11",
    "22",
    "25",
    "26",
    "36"
  ],
  "premiacoes": [
    {
      "acertos": "Sena",
      "vencedores": 0,
      "premio": "-"
    },
    {
      "acertos": "Quina",
      "vencedores": 46,
      "premio": "35.595,61"
    },
    {
      "acertos": "Quadra",
      "vencedores": 2988,
      "premio": "782,84"
    }
  ],
  "estadosPremiados": [],
  "acumulou": true,
  "acumuladaProxConcurso": "R$ 7 Milhões",
  "dataProxConcurso": "27/11//2021",
  "proxConcurso": 2432,
  "timeCoracao": null,
  "mesSorte": null
}

• Resultado Específico

https://loteriascaixa-api.herokuapp.com/api/<loteria>/<concurso>

Lotofácil, concurso 2027: https://loteriascaixa-api.herokuapp.com/api/lotofacil/2027

{
  "loteria": "lotofacil",
  "nome": "Lotofácil",
  "concurso": 2027,
  "data": "02/09/2020",
  "local": "Espaço Loterias Caixa em SÃO PAULO, SP",
  "dezenas": [
    "01",
    "02",
    "03",
    "06",
    "07",
    "09",
    "12",
    "13",
    "16",
    "17",
    "20",
    "21",
    "23",
    "24",
    "25"
  ],
  "premiacoes": [
    {
      "acertos": "15 Pontos",
      "vencedores": 2,
      "premio": "1.617.835,87"
    },
    {
      "acertos": "14 Pontos",
      "vencedores": 408,
      "premio": "1.393,71"
    },
    {
      "acertos": "13 Pontos",
      "vencedores": 13288,
      "premio": "25,00"
    },
    {
      "acertos": "12 Pontos",
      "vencedores": 146003,
      "premio": "10,00"
    },
    {
      "acertos": "11 Pontos",
      "vencedores": 782964,
      "premio": "5,00"
    }
  ],
  "estadosPremiados": [
    {
      "nome": "Maranhão",
      "uf": "MA",
      "vencedores": "1",
      "latitude": "42.4072107",
      "longitude": "-71.3824374",
      "cidades": [
        {
          "cidade": "São Mateus do Maranhão",
          "vencedores": "1",
          "latitude": "-4.030871299999999",
          "longitude": "-44.4654609"
        }
      ]
    },
    {
      "nome": "São Paulo",
      "uf": "SP",
      "vencedores": "1",
      "latitude": "-23.5557714",
      "longitude": "-46.6395571",
      "cidades": [
        {
          "cidade": "Presidente Epitácio",
          "vencedores": "1",
          "latitude": "-21.7668273",
          "longitude": "-52.1096821"
        }
      ]
    }
  ],
  "acumulou": false,
  "acumuladaProxConcurso": "",
  "dataProxConcurso": "",
  "proxConcurso": 2028,
  "timeCoracao": null,
  "mesSorte": null
}

• Observações sobre o retorno

Os campos timeCoracao e mesSorte só terão algum valor quando a loteria pesquisada for Timemania (timemania) ou Dia de Sorte (dia-de-sorte) respectivamente.

Documentação da API

Para mais informações sobre todas as operações da API acesse:

https://loteriascaixa-api.herokuapp.com

URL's Alternativas

Em caso de indisponibilidade de serviço, a API possui algumas URL's alternativas que podem ser usadas para manter sua aplicação cliente funcionando. Por exemplo em caso de erro ao tentar https://loteriascaixa-api.herokuapp.com/api/mega-sena/latest podemos substituir a URL base https://loteriascaixa-api.herokuapp.com por uma das listadas abaixo, tal como https://loterias-gutotech.herokuapp.com, resultando então em https://loterias-gutotech.herokuapp.com/api/mega-sena/latest. E não se preoculpe, o resultado retornado usando qualquer URL base alternativa será o mesmo (correto e atualizado como sempre) caso não tivesse ocorrido erro na primeira tentativa.

• https://loterias-gutotech.herokuapp.com

• https://loterias-caixa-gov.herokuapp.com

Contribuição

Quaisquer contribuições para este repositório são bem-vindas.