Skip to content

πŸ“§ Layanan pengirim pesan elektronik (email) dengan API.

Notifications You must be signed in to change notification settings

feri-irawan/fimail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“§ Fimail

Visitor GitHub deployments

Fimail, layanan pengirim pesan elektronik dengan API. Dibuat dengan ❀ dan NodeJs oleh Feri Irawan pada 31/12/2021 06.27

⚑ Memulai Cepat

Berikut ini contoh sederhana permintaan API untuk memulai cepat.

curl -X POST 'https://fimail.vercel.app/send' \
-H 'Content-Type: application/json' \
-d '{
    "from": {
        "name": "<YOUR NAME>",
        "address": "<YOUR EMAIL>"
    },
    "to": {
        "name": "<RECEPTION NAME>",
        "address": "<RECEPTION EMAIL>"
    },
    "subject": "Fimail - Simple Mail",
    "contents": "Lorem ipsum dolor sit amet consectetur adipisicing elit."
}'

πŸ‘₯ Multi Pengguna

Jika kamu ingin mengirim ke beberapa pengguna, kamu bisa menuliskan email pengguna-pengguna dalam bentuk array.

Contoh:

curl -X POST 'https://fimail.vercel.app/send' \
-H 'Content-Type: application/json' \
-d '{
    "from": {
        "name": "<YOUR NAME>",
        "address": "<YOUR EMAIL>"
    },
    "to": [
        {
            "name": "<RECEPTION NAME 1>",
            "address": "<RECEPTION EMAIL 1>"
        },
        {
            "name": "<RECEPTION NAME 2>",
            "address": "<RECEPTION EMAIL 2>"
        },
        {
            "name": "<RECEPTION NAME 3>",
            "address": "<RECEPTION EMAIL 3>"
        },
    ],
    "subject": "Fimail - Multiple Receptions",
    "contents": "Lorem ipsum dolor sit amet consectetur adipisicing elit."
}'

Informasi pengirim dan penerima (to, cc, bc, dan bcc) juga boleh ditulis seperti ini:

{
    "from": "\"My Name\" <[email protected]>",
    "to": "\"Reception 1\" <[email protected]>,\"Reception 2\" <[email protected]>,\"Reception 3\" <[email protected]>",
    
    // Or

    "from": "[email protected]",
    "to": "[email protected],[email protected],[email protected]"
}

πŸ‘©πŸ»β€πŸ’» Konten HTML

Secara default pesan yang dikirim sudah dalam format HTML, jadi kamu ingin mengirim konten berupa kode HTML, maka kamu bisa langsung menuliskannya seperti berikut.

curl -X POST 'https://fimail.vercel.app/send' \
-H 'Content-Type: application/json' \
-d '{
    "from": {
        "name": "<YOUR NAME>",
        "address": "<YOUR EMAIL>"
    },
    "to": {
        "name": "<RECEPTION NAME>",
        "address": "<RECEPTION EMAIL>"
    },
    "subject": "Fimail - HTML Mail",
    "contents": "<b>Lorem ipsum dolor sit amet consectetur adipisicing elit.</b>"
}'

πŸ“Ž Dengan Lampiran

Kamu juga bisa mengirim lampiran seperti file, gambar dengan cara menambahkan properti attachments pada body.

🌐 Menggunakan URL atau URI Base64

Kamu bisa mengirimkan lampiran yang kontenya diambil dari URL atau base64, seperti berikut.

Contoh 1 - Menggunakan URL:

curl -X POST 'https://fimail.vercel.app/send' \
-H 'Content-Type: application/json' \
-d '{
    "from": {
        "name": "<YOUR NAME>",
        "address": "<YOUR EMAIL>"
    },
    "to": {
        "name": "<RECEPTION NAME>",
        "address": "<RECEPTION EMAIL>"
    },
    "subject": "Fimail - With Attachments",
    "contents": "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
    "attachments: {
        "filename": "myimage.jpg",
        "path": "https://dummyimage.com/400x400/00ffbf/000000.jpg"
    }
}'

Contoh 2 - Menggunakan URI Base64:

curl -X POST 'https://fimail.vercel.app/send' \
-H 'Content-Type: application/json' \
-d '{
    "from": {
        "name": "<YOUR NAME>",
        "address": "<YOUR EMAIL>"
    },
    "to": {
        "name": "<RECEPTION NAME>",
        "address": "<RECEPTION EMAIL>"
    },
    "subject": "Fimail - With Attachments",
    "contents": "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
    "attachments: {
        "filename": "myimage.jpg",
        "path": "data:text/plain;base64,aGVsbG8gd29ybGQ="
    }
}'

πŸ‘©πŸ»β€πŸ’» Menggunakan String, Buffer, Stream

Kamu juga bisa mengirimkan lampiran yang kontennya berupa string, buffer, atau stream.

Contoh:

curl -X POST 'https://fimail.vercel.app/send' \
-H 'Content-Type: application/json' \
-d '{
    "from": {
        "name": "<YOUR NAME>",
        "address": "<YOUR EMAIL>"
    },
    "to": {
        "name": "<RECEPTION NAME>",
        "address": "<RECEPTION EMAIL>"
    },
    "subject": "Fimail - With Attachments",
    "contents": "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
    "attachments: {
        "filename": "mytext.txt",
        "content": "<STRING or BUFFER or STREAM>"
    }
}'

Jika kontennya diambil dari buffer atau stream maka, kamu bisa melukan hal yang sama seperti contoh di atas ini.

πŸ–‡ Multi Lampiran

Kamu juga bisa mengirim beberapa lampiran dengan cara menyusunnya ke dalam bentuk array seperti berikut ini.

curl -X POST 'https://fimail.vercel.app/send' \
-H 'Content-Type: application/json' \
-d '{
    "from": {
        "name": "<YOUR NAME>",
        "address": "<YOUR EMAIL>"
    },
    "to": {
        "name": "<RECEPTION NAME>",
        "address": "<RECEPTION EMAIL>"
    },
    "subject": "Fimail - With Attachments",
    "contents": "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
    "attachments: [
        {
            "filename": "myimage.jpg",
            "path": "https://dummyimage.com/400x400/00ffbf/000000.jpg"
        },
        {
            "filename": "myimage2.jpg",
            "path": "https://dummyimage.com/400x400/ffd000/000000.jpg"
        },
        {
            "filename": "mytext.txt",
            "content": "Hello World!"
        }
    ]
}'

Nah, seperti itulah cara melakukan permintaan API ke Fimail untuk mengirim email.

Semoga bermanfaat, terima kasih.