{"id":22567793,"url":"https://github.com/peter2k3/mail-sender-spring","last_synced_at":"2026-04-25T23:32:08.623Z","repository":{"id":260846321,"uuid":"882512903","full_name":"Peter2k3/mail-sender-spring","owner":"Peter2k3","description":"A microservice for send verification codes using spring mail","archived":false,"fork":false,"pushed_at":"2024-11-15T01:13:35.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T14:12:18.131Z","etag":null,"topics":["spring","spring-mail"],"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/Peter2k3.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-03T01:10:13.000Z","updated_at":"2024-11-15T01:13:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"55479261-9658-417b-980a-d5aada461c56","html_url":"https://github.com/Peter2k3/mail-sender-spring","commit_stats":null,"previous_names":["peter2k3/mail-sender-spring"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter2k3%2Fmail-sender-spring","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter2k3%2Fmail-sender-spring/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter2k3%2Fmail-sender-spring/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Peter2k3%2Fmail-sender-spring/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Peter2k3","download_url":"https://codeload.github.com/Peter2k3/mail-sender-spring/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246040925,"owners_count":20714091,"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":["spring","spring-mail"],"created_at":"2024-12-08T00:09:12.444Z","updated_at":"2026-04-25T23:32:08.590Z","avatar_url":"https://github.com/Peter2k3.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mail-sender-spring\nA microservice for send verification codes using spring mail\nAquí tienes una guía para usuarios externos que quieran interactuar con el endpoint `POST /v1/confirm-mail/send-html`, en un estilo de documentación que puede ser útil para incluir en tu documentación API.\n\n---\n\n### Enviar un correo de verificación\n\n**Endpoint:** `POST /v1/confirm-mail/send-html`\n\nEste endpoint permite enviar un correo electrónico de verificación en formato HTML a un usuario registrado. El correo incluye un código de verificación y el correo electrónico del destinatario. Se usa comúnmente para completar el proceso de verificación de usuario.\n\n#### URL\n\n```\nPOST /v1/confirm-mail/send-html\n```\n\n#### Headers\n\n- `Content-Type: application/json`\n\n#### Request Body\n\nEl cuerpo de la solicitud debe ser un objeto JSON con la siguiente estructura:\n\n```json\n{\n  \"idUserVerification\": \"string\",\n  \"code\": \"integer\",\n  \"user\": {\n    \"idUsuario\": \"string\",\n    \"email\": \"string\"\n  }\n}\n```\n\n- `idUserVerification` (string): Un identificador único para la verificación de usuario.\n- `code` (integer): El código de verificación que se enviará al usuario.\n- `user` (object):\n  - `idUsuario` (string): Identificador único del usuario.\n  - `email` (string): Correo electrónico del usuario al que se enviará el mensaje de verificación.\n\n#### Ejemplo de Request\n\n```json\nPOST /v1/confirm-mail/send-html\nContent-Type: application/json\n\n{\n  \"idUserVerification\": \"123\",\n  \"code\": 123456,\n  \"user\": {\n    \"idUsuario\": \"789\",\n    \"email\": \"example@correo.com\"\n  }\n}\n```\n\n#### Respuestas\n\n**200 OK**\n- **Descripción:** El correo de verificación se envió correctamente al usuario.\n- **Ejemplo de respuesta:**\n  ```json\n  {\n    \"message\": \"Email enviado con éxito a example@correo.com\"\n  }\n  ```\n\n**500 Internal Server Error**\n- **Descripción:** Hubo un error al intentar enviar el correo electrónico.\n- **Ejemplo de respuesta:**\n  ```json\n  {\n    \"message\": \"Error enviando el email a example@correo.com\"\n  }\n  ```\n\n#### Errores Comunes\n\n- **400 Bad Request**: Se envió un `Request Body` incompleto o con un formato incorrecto.\n- **500 Internal Server Error**: Falló la conexión con el servidor de correo o el servicio de envío de correos no está configurado correctamente.\n\n#### Notas Adicionales\n\n- Asegúrate de que el correo electrónico proporcionado en `user.email` sea válido.\n- El `code` debe ser un número entero y representa el código de verificación que el usuario necesitará para completar el proceso de verificación.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeter2k3%2Fmail-sender-spring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeter2k3%2Fmail-sender-spring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeter2k3%2Fmail-sender-spring/lists"}