{"id":20230426,"url":"https://github.com/amir-shiati/email-verification-api","last_synced_at":"2025-08-14T12:36:16.932Z","repository":{"id":44546565,"uuid":"454300994","full_name":"amir-shiati/email-verification-api","owner":"amir-shiati","description":"A Fast, Secure, Ready to use, Highly customizable email verifier API.","archived":false,"fork":false,"pushed_at":"2022-02-08T21:28:55.000Z","size":54,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T15:47:26.852Z","etag":null,"topics":["email-sender","email-validation","email-validation-api","email-validator","rest-api","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amir-shiati.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-01T07:45:46.000Z","updated_at":"2023-12-29T05:33:48.000Z","dependencies_parsed_at":"2022-07-25T00:16:07.277Z","dependency_job_id":null,"html_url":"https://github.com/amir-shiati/email-verification-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir-shiati%2Femail-verification-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir-shiati%2Femail-verification-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir-shiati%2Femail-verification-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amir-shiati%2Femail-verification-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amir-shiati","download_url":"https://codeload.github.com/amir-shiati/email-verification-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248265640,"owners_count":21075017,"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":["email-sender","email-validation","email-validation-api","email-validator","rest-api","spring-boot"],"created_at":"2024-11-14T07:42:31.383Z","updated_at":"2025-04-10T18:05:00.864Z","avatar_url":"https://github.com/amir-shiati.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Email verification API\n\n![Screenshot](https://i.postimg.cc/NFst1m6S/Screenshot.png)\n\n# What is this?\n\nA **Fast, Secure, Ready to use, Highly customizable** email verifier API.\n\n# How to use\n\n### Clone the project\n\n    git clone https://github.com/amir-shiati/email-verification-api.git\n\n### [Edit the configuration file](#Edit-the-configuration-file)\n\n    vi email-verification-api/src/main/resources/application.yml\n\n### Done! Run the project...\n\n    mvn spring-boot:run\n\n# Edit the configuration file\n\nopen up **application.yml** file (located inside email-verification-api/src/main/resources/) and set the required\ninformation.\n\n### set your smtp server information:\n\n```yaml\nsmtp:\n  # your smtp server host\n  host: smtp.your-domain.com\n  # your smtp server port\n  port: 587\n  # your smtp server username\n  username: your-smtp-username\n  # your smtp server password\n  password: your-smtp-password\n```\n\n### set your database information:\n\n```yaml\ndatasource:\n  # database url\n  jdbc-url: jdbc:postgresql://localhost:5432/your-database-name\n  # database username\n  username: your-database-username\n  # database password\n  password: your-database-password\n```\n\n### change jwt user information:\n\n```yaml\nsecurity:\n  jwt:\n    # jwt username (used to get jwt authentication token)\n    username: changeme\n    # jwt password (used to get jwt authentication token)\n    password: changeme\n```\n\n## All set!\n\n# Customizing\n\n**You can customize both the code and the html content of the email.**\n\n### Customizing html content of the email:\n\nopen up **application.yml** file (located inside email-verification-api/src/main/resources/).\n\nInside the **html** section change these variables:\n\n```yaml\nhtml:\n  template:\n    # path to the html template\n    path: src/main/resources/templates/\n    # name of the html template file\n    file-name: template\n    # name of the variable used for code inside the html template\n    variable-name: code\n```\n\n- **Template file is a html file but because of the templating engine used it must end with a chtml extension!**\n- **Indicate where you would want to put the generated code inside the html file using the {$code} tag.**\n\n### Customizing the code\n\nInside the **code** section change these variables:\n\n```yaml\ncode:\n  # the length of the code\n  length: 6\n  # should it contain digits?\n  digits: true\n  # should it contain uppercase letters?\n  upper: false\n  # should it contain lowercase letters?\n  lower: false\n  # How long should the code be valid?\n  valid-for-minutes: 5\n```\n\n# Security\n\n**All the endpoints have been secured using jwt.**\n\n# Endpoints\n[Here is the documentation ](https://github.com/amir-shiati/email-verification-api/blob/main/doc.md)\n\n# TODO\n- [ ] Add post configuration\n- [ ] Add a queue\n- [ ] Add support for bulk validation\n- [ ] Dockerize the project\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famir-shiati%2Femail-verification-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famir-shiati%2Femail-verification-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famir-shiati%2Femail-verification-api/lists"}