{"id":19737468,"url":"https://github.com/jacksonsr451/api-email-service","last_synced_at":"2026-05-06T13:06:14.036Z","repository":{"id":195258432,"uuid":"692559067","full_name":"jacksonsr451/api-email-service","owner":"jacksonsr451","description":"Email Service: A Python-based email service using Flask and Clean Architecture. Send emails easily through a RESTful API, with support for various email providers like AWS SES.","archived":false,"fork":false,"pushed_at":"2023-09-16T22:05:54.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-10T19:24:18.303Z","etag":null,"topics":["aws-ses","clean-architecture","email-sender","email-service","flask","python"],"latest_commit_sha":null,"homepage":"https://github.com/jacksonsr451/api-email-server","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jacksonsr451.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":"2023-09-16T21:17:55.000Z","updated_at":"2023-09-16T21:22:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"aa7760f1-ee32-4277-99df-bbfe476b8a1b","html_url":"https://github.com/jacksonsr451/api-email-service","commit_stats":null,"previous_names":["jacksonsr451/api-email-service"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksonsr451%2Fapi-email-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksonsr451%2Fapi-email-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksonsr451%2Fapi-email-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jacksonsr451%2Fapi-email-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jacksonsr451","download_url":"https://codeload.github.com/jacksonsr451/api-email-service/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241062992,"owners_count":19903006,"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":["aws-ses","clean-architecture","email-sender","email-service","flask","python"],"created_at":"2024-11-12T01:11:14.766Z","updated_at":"2026-05-06T13:06:08.993Z","avatar_url":"https://github.com/jacksonsr451.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Email Service\n\nEste é um serviço de e-mail construído em Python com o framework Flask, seguindo uma arquitetura modular com as seguintes camadas: Core, Application, Infrastructure, Adapters e Controllers. Ele fornece uma rota POST para enviar e-mails.\n\n## Instalação\n\nAntes de começar, certifique-se de ter o Python e o Poetry instalados. Se você ainda não tem o Poetry, você pode instalá-lo seguindo as [instruções oficiais](https://python-poetry.org/docs/#installation).\n\nApós instalar o Poetry, você pode criar um ambiente virtual para o projeto executando o seguinte comando na raiz do projeto:\n\n```bash\npoetry install\n```\n\n## Configuração\n\nAntes de executar o serviço, você precisa configurar as variáveis de ambiente para autenticar-se com um serviço de e-mail, como o AWS SES. Crie um arquivo .env na raiz do projeto e configure as seguintes variáveis:\n\nenv\n\nAWS_ACCESS_KEY_ID=seu-id-de-chave-de-acesso\nAWS_SECRET_ACCESS_KEY=sua-chave-secreta-de-acesso\nAWS_REGION=sua-região-da-aws\n\n## Uso\n\nPara iniciar o serviço, execute o seguinte comando:\n\n```bash\npoetry run flask run\n```\n\n**O serviço estará disponível em** `http://localhost:5000`.\n\n## Enviar um e-mail\n\nVocê pode enviar um e-mail fazendo uma solicitação POST para a rota `/api/v1/email/`.\n**Aqui está um exemplo de solicitação usando cURL:**\n\n```bash\n\ncurl -X POST http://localhost:5000/api/v1/email/ -H \"Content-Type: application/json\" -d '{\n  \"to\": \"destinatario@example.com\",\n  \"subject\": \"Assunto do E-mail\",\n  \"body\": \"Conteúdo do e-mail\"\n}'\n```\n\n### Resposta\n\n- O serviço responderá com um JSON indicando se o e-mail foi enviado com sucesso ou não.\n\n## Estrutura do Projeto\n\n- A estrutura do projeto segue uma arquitetura modular com as seguintes camadas:\n\n  - core/: Camada central com entidades e lógica de negócios.\n\n  - application/: Camada de aplicação que contém casos de uso.\n\n  - infrastructure/: Camada de infraestrutura com adaptadores, como o adaptador para serviços de e-mail.\n\n  - adapters/: Camada de adaptadores para integrações externas.\n\n  - email_service/: Pacote que atua como a camada de aplicação (app) e contém os blueprints.\n\n  - controllers/: Camada de controladores para manipulação das solicitações HTTP.\n\n  - app.py: Configuração principal do Flask e definição de rotas.\n\n## Contribuindo\n\nSinta-se à vontade para contribuir com melhorias para este projeto. Você pode abrir problemas (issues) e enviar solicitações de pull (pull requests) para colaborar.\nLicença\n\nEste projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacksonsr451%2Fapi-email-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjacksonsr451%2Fapi-email-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjacksonsr451%2Fapi-email-service/lists"}