From d47c06c4dd80b1b182674ebb7c041a176d20717c Mon Sep 17 00:00:00 2001 From: Andros Fenollosa Date: Mon, 15 Jun 2020 20:21:33 +0200 Subject: [PATCH] Update README.md --- README.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) diff --git a/README.md b/README.md index 833ecc8..c4ae0ff 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,67 @@ +

+ Explication +

+ +## Run + +1) Make sure you have Java installed. + +Debian/Ubuntu + +``` sh +sudo apt install default-jre +``` + +Mac OS + +``` sh +brew install java +``` + +2) Create a file `config.yaml` with the following content. You can also use `config.yaml.example` as a base config and change it to fit your needs. + +``` yaml +# It can be a domain in case of using a proxy: example.com +domain: localhost +# It indicates which domain can use it. Debug true so there are no limitations. +domain-cli: localhost +# If it is active it will be accessible to any client +debug: true +port: 7404 +#SMTP config +smtp-from: "no-reply@domain.com" +smtp-to: "my@domain.com" +smtp-subject: "Contact" +smtp-host: "smtp.domain.com" +smtp-user: "" +smtp-password: "" +smtp-port: 587 +smtp-tls: true +``` + +3) Download the latest version of Glosa (`api2smtp-{version}-standalone.jar`). + +https://github.com/tanrax/api2smtp/releases + + +4) Now you can execute api2smtp. + +```sh +java -jar target/api2smtp-{version}-standalone.jar +``` + +Great 🎉. You already have your 🔥 own API send mails 🔥. + +That's it, now you just have to test that it works properly. + +``` sh +curl -H "Content-type: application/json" -d '{ + "name": "Cid", + "subject": "Awesome", + "email": "cid@campeador.es", + "message": "Attack!!" +}' 'localhost:7404/api/v1/email/' +``` ---