{"id":21275471,"url":"https://github.com/mk-nascimento/fastapi-loterias-api","last_synced_at":"2026-04-12T00:05:37.384Z","repository":{"id":255083135,"uuid":"835937743","full_name":"mk-nascimento/fastapi-loterias-api","owner":"mk-nascimento","description":"Esta API foi desenvolvido para consulta dos resultados das loterias da Caixa Econômica Federal do Brasil.","archived":false,"fork":false,"pushed_at":"2024-08-27T21:47:04.000Z","size":31,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T03:24:58.099Z","etag":null,"topics":["docker","docker-compose","fastapi","mongodb","poetry","python3","redis"],"latest_commit_sha":null,"homepage":"https://loterias.api.mk-nascimento.online/docs","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mk-nascimento.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-30T20:32:45.000Z","updated_at":"2024-08-27T21:47:08.000Z","dependencies_parsed_at":"2024-08-27T23:23:05.536Z","dependency_job_id":null,"html_url":"https://github.com/mk-nascimento/fastapi-loterias-api","commit_stats":null,"previous_names":["mk-nascimento/fastapi-loterias-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk-nascimento%2Ffastapi-loterias-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk-nascimento%2Ffastapi-loterias-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk-nascimento%2Ffastapi-loterias-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mk-nascimento%2Ffastapi-loterias-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mk-nascimento","download_url":"https://codeload.github.com/mk-nascimento/fastapi-loterias-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243732303,"owners_count":20338839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","fastapi","mongodb","poetry","python3","redis"],"created_at":"2024-11-21T09:32:22.681Z","updated_at":"2026-04-12T00:05:37.356Z","avatar_url":"https://github.com/mk-nascimento.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fastapi-loterias-api\nEsta API foi desenvolvido para consulta dos resultados das loterias da Caixa Econômica Federal do Brasil. A aplicação permite acessar os resultados mais recentes ou de concursos específicos através de rotas simples. Utiliza MongoDB para armazenamento dos dados e Redis para cache, melhorando o desempenho das consultas.\n\n## Funcionalidades\n\n- **Consulta do último resultado de uma loteria**: Obtenha o último resultado disponível para uma loteria específica.\n- **Consulta de resultado por concurso**: Acesse o resultado de um concurso específico através do seu número.\n- **Armazenamento e cache**: Usa MongoDB para persistência de dados e Redis para cache dos resultados mais recentes.\n\n## Instalação\n\n1. **Pré-requisitos**:\n   - [![Python 3.11+](https://img.shields.io/badge/Python-3.11+-3776AB.svg?logo=python)](https://www.python.org/downloads/release/python-3110/)\n   - [![MongoDB](https://img.shields.io/badge/MongoDB-7.0+-4FAA41.svg?logo=mongodb)](https://www.mongodb.com/pt-br/docs/manual/installation/)\n   - [![Redis](https://img.shields.io/badge/Redis-7.4+-DC382D.svg?logo=redis)](https://www.example.org)\n    - [![Poetry 1.8+](https://img.shields.io/badge/Poetry-1.8+-60A5FA.svg?logo=poetry)](https://python-poetry.org/docs/#installation)\n\n2. **Clonar o repositório**:\n   ```bash\n   git clone https://github.com/mk-nascimento/fastapi-loterias-api.git\n   cd fastapi-loterias-api\n   ```\n\n3. **Instalar as dependências**:\n\n    - Poetry\n        \u003e Antes de prosseguir com a instalação, é recomendado verificar a versão do Python e Poetry recomendada no topo deste arquivo. Certifique-se de ter a versão correta instalada em seu sistema antes de continuar.\n        ```sh\n        poetry install\n        ```\n\n    - Ou, se você preferir usar pip:\n        \u003e Antes de prosseguir com a instalação, é recomendado verificar a versão do Python recomendada no topo deste arquivo. Certifique-se de ter a versão correta instalada em seu sistema antes de continuar.\n        ```sh\n        pip install -r requirements.txt\n        ```\n\n4. **Configurar variáveis de ambiente**:\n   - Crie um arquivo `.env` partindo do [.env.example](.env.example):\n   ```bash\n    cp .env.example .env\n   ```\n\n5. **Executar a aplicação**:\n   ```bash\n   poetry run fastapi run loterias/main.py\n   ```\n\n   A aplicação estará disponível em `http://localhost:8000`.\n\n## Rotas Disponíveis\n\n### 1. **Índice**\n\n- **GET /**\n  Retorna uma página HTML simples com um link para a documentação Swagger.\n\n  **Exemplo de resposta**:\n  ```html\n  Visit Swagger documentation at: \u003ca href='/docs'\u003e/docs\u003c/a\u003e\n  ```\n\n### 2. **Obter o último resultado de uma loteria**\n\n- **GET /{loteria}**\n  Retorna o último resultado disponível para a loteria especificada.\n\n  **Parâmetros**:\n  - `loteria` (str): Nome da loteria (ex: \"megasena\", \"quina\").\n\n  **Exemplo de resposta**:\n  ```json\n  {\n    \"_id\": \"64dfc...\",\n    \"acumulado\": false,\n    \"dataApuracao\": \"01/01/2001\",\n    ...\n  }\n  ```\n\n### 3. **Obter o resultado de um concurso específico**\n\n- **GET /{loteria}/{concurso}**\n  Retorna o resultado do concurso especificado para a loteria.\n\n  **Parâmetros**:\n  - `loteria` (str): Nome da loteria (ex: \"megasena\", \"quina\").\n  - `concurso` (int): Número do concurso (ex: 123).\n\n  **Exemplo de resposta**:\n  ```json\n  {\n    \"_id\": \"64dfc...\",\n    \"acumulado\": false,\n    \"dataApuracao\": \"01/01/2001\",\n    ...\n  }\n  ```\n\n  **Erros possíveis**:\n  - `404 NOT FOUND`: Quando o concurso solicitado não é encontrado.\n\n## Considerações\n\n- A rota `/` é oculta no Swagger e serve apenas para redirecionar os usuários à documentação da API.\n- As rotas foram projetadas para ser simples e intuitivas, com tratamento de erros e validação de parâmetros.\n\n## Contribuição\n\nContribuições são bem-vindas! Por favor, envie um pull request ou abra uma issue para discutir as mudanças que deseja fazer.\n\n## Licença\n\nEste projeto está licenciado sob a licença Apache 2.0 - veja o arquivo [LICENSE](LICENSE) para detalhes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmk-nascimento%2Ffastapi-loterias-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmk-nascimento%2Ffastapi-loterias-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmk-nascimento%2Ffastapi-loterias-api/lists"}