{"id":13619302,"url":"https://github.com/feri-irawan/fimail","last_synced_at":"2025-04-14T16:31:00.101Z","repository":{"id":119692876,"uuid":"446018004","full_name":"feri-irawan/fimail","owner":"feri-irawan","description":"📧 Layanan pengirim pesan elektronik (email) dengan API.","archived":false,"fork":false,"pushed_at":"2022-01-24T15:22:14.000Z","size":11,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-01-28T23:11:36.525Z","etag":null,"topics":["fimail","gmail","javascript","mail","mailer","nodemailer","open-source","project","sendmail","sendmailer","smtp"],"latest_commit_sha":null,"homepage":"https://fimail.vercel.app","language":"JavaScript","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/feri-irawan.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}},"created_at":"2022-01-09T07:04:45.000Z","updated_at":"2024-04-23T13:33:06.089Z","dependencies_parsed_at":null,"dependency_job_id":"b20250a1-a1c7-4aa9-8a97-be75a225c8b4","html_url":"https://github.com/feri-irawan/fimail","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/feri-irawan%2Ffimail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feri-irawan%2Ffimail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feri-irawan%2Ffimail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feri-irawan%2Ffimail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/feri-irawan","download_url":"https://codeload.github.com/feri-irawan/fimail/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248916561,"owners_count":21182827,"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":["fimail","gmail","javascript","mail","mailer","nodemailer","open-source","project","sendmail","sendmailer","smtp"],"created_at":"2024-08-01T21:00:37.746Z","updated_at":"2025-04-14T16:30:59.843Z","avatar_url":"https://github.com/feri-irawan.png","language":"JavaScript","funding_links":[],"categories":["F"],"sub_categories":[],"readme":"# 📧 Fimail\n\n![Visitor](https://fibadge.vercel.app/badges/visitors/feri-irawan/fimail)\n![GitHub deployments](https://img.shields.io/github/deployments/feri-irawan/fimail/production?label=vercel\u0026logo=vercel\u0026style=for-the-badge)\n\nFimail, layanan pengirim pesan elektronik dengan API. Dibuat dengan ❤ dan NodeJs oleh [Feri Irawan](https://github.com/feri-irawan) pada 31/12/2021 06.27\n\n## ⚡ Memulai Cepat\n\nBerikut ini contoh sederhana permintaan API untuk memulai cepat.\n\n```bash\ncurl -X POST 'https://fimail.vercel.app/send' \\\n-H 'Content-Type: application/json' \\\n-d '{\n    \"from\": {\n        \"name\": \"\u003cYOUR NAME\u003e\",\n        \"address\": \"\u003cYOUR EMAIL\u003e\"\n    },\n    \"to\": {\n        \"name\": \"\u003cRECEPTION NAME\u003e\",\n        \"address\": \"\u003cRECEPTION EMAIL\u003e\"\n    },\n    \"subject\": \"Fimail - Simple Mail\",\n    \"contents\": \"Lorem ipsum dolor sit amet consectetur adipisicing elit.\"\n}'\n```\n\n## 👥 Multi Pengguna\n\nJika kamu ingin mengirim ke beberapa pengguna, kamu bisa menuliskan email pengguna-pengguna dalam bentuk *array*.\n\n**Contoh:**\n\n```bash\ncurl -X POST 'https://fimail.vercel.app/send' \\\n-H 'Content-Type: application/json' \\\n-d '{\n    \"from\": {\n        \"name\": \"\u003cYOUR NAME\u003e\",\n        \"address\": \"\u003cYOUR EMAIL\u003e\"\n    },\n    \"to\": [\n        {\n            \"name\": \"\u003cRECEPTION NAME 1\u003e\",\n            \"address\": \"\u003cRECEPTION EMAIL 1\u003e\"\n        },\n        {\n            \"name\": \"\u003cRECEPTION NAME 2\u003e\",\n            \"address\": \"\u003cRECEPTION EMAIL 2\u003e\"\n        },\n        {\n            \"name\": \"\u003cRECEPTION NAME 3\u003e\",\n            \"address\": \"\u003cRECEPTION EMAIL 3\u003e\"\n        },\n    ],\n    \"subject\": \"Fimail - Multiple Receptions\",\n    \"contents\": \"Lorem ipsum dolor sit amet consectetur adipisicing elit.\"\n}'\n```\n\nInformasi pengirim dan penerima (`to`, `cc`, `bc`, dan `bcc`) juga boleh ditulis seperti ini:\n\n```jsonc\n{\n    \"from\": \"\\\"My Name\\\" \u003cmyemail@gmail.com\u003e\",\n    \"to\": \"\\\"Reception 1\\\" \u003creception1@gmail.com\u003e,\\\"Reception 2\\\" \u003creception2@gmail.com\u003e,\\\"Reception 3\\\" \u003creception3@gmail.com\u003e\",\n    \n    // Or\n\n    \"from\": \"myemail@gmail.com\",\n    \"to\": \"reception1@gmail.com,reception2@gmail.com,reception3@gmail.com\"\n}\n```\n\n## 👩🏻‍💻 Konten HTML\n\nSecara default pesan yang dikirim sudah dalam format HTML, jadi kamu ingin mengirim konten berupa kode HTML, maka kamu bisa langsung menuliskannya seperti berikut.\n\n```bash\ncurl -X POST 'https://fimail.vercel.app/send' \\\n-H 'Content-Type: application/json' \\\n-d '{\n    \"from\": {\n        \"name\": \"\u003cYOUR NAME\u003e\",\n        \"address\": \"\u003cYOUR EMAIL\u003e\"\n    },\n    \"to\": {\n        \"name\": \"\u003cRECEPTION NAME\u003e\",\n        \"address\": \"\u003cRECEPTION EMAIL\u003e\"\n    },\n    \"subject\": \"Fimail - HTML Mail\",\n    \"contents\": \"\u003cb\u003eLorem ipsum dolor sit amet consectetur adipisicing elit.\u003c/b\u003e\"\n}'\n```\n\n## 📎 Dengan Lampiran\n\nKamu juga bisa mengirim lampiran seperti file, gambar dengan cara menambahkan properti `attachments` pada body.\n\n### 🌐 Menggunakan URL atau URI Base64\n\nKamu bisa mengirimkan lampiran yang kontenya diambil dari URL atau base64, seperti berikut.\n\n**Contoh 1 - Menggunakan URL:**\n\n```bash\ncurl -X POST 'https://fimail.vercel.app/send' \\\n-H 'Content-Type: application/json' \\\n-d '{\n    \"from\": {\n        \"name\": \"\u003cYOUR NAME\u003e\",\n        \"address\": \"\u003cYOUR EMAIL\u003e\"\n    },\n    \"to\": {\n        \"name\": \"\u003cRECEPTION NAME\u003e\",\n        \"address\": \"\u003cRECEPTION EMAIL\u003e\"\n    },\n    \"subject\": \"Fimail - With Attachments\",\n    \"contents\": \"Lorem ipsum dolor sit amet consectetur adipisicing elit.\",\n    \"attachments: {\n        \"filename\": \"myimage.jpg\",\n        \"path\": \"https://dummyimage.com/400x400/00ffbf/000000.jpg\"\n    }\n}'\n```\n\n**Contoh 2 - Menggunakan URI Base64:**\n\n```bash\ncurl -X POST 'https://fimail.vercel.app/send' \\\n-H 'Content-Type: application/json' \\\n-d '{\n    \"from\": {\n        \"name\": \"\u003cYOUR NAME\u003e\",\n        \"address\": \"\u003cYOUR EMAIL\u003e\"\n    },\n    \"to\": {\n        \"name\": \"\u003cRECEPTION NAME\u003e\",\n        \"address\": \"\u003cRECEPTION EMAIL\u003e\"\n    },\n    \"subject\": \"Fimail - With Attachments\",\n    \"contents\": \"Lorem ipsum dolor sit amet consectetur adipisicing elit.\",\n    \"attachments: {\n        \"filename\": \"myimage.jpg\",\n        \"path\": \"data:text/plain;base64,aGVsbG8gd29ybGQ=\"\n    }\n}'\n```\n\n### 👩🏻‍💻 Menggunakan String, Buffer, Stream\n\nKamu juga bisa mengirimkan lampiran yang kontennya berupa *string*, *buffer*, atau *stream*.\n\n**Contoh:**\n\n```bash\ncurl -X POST 'https://fimail.vercel.app/send' \\\n-H 'Content-Type: application/json' \\\n-d '{\n    \"from\": {\n        \"name\": \"\u003cYOUR NAME\u003e\",\n        \"address\": \"\u003cYOUR EMAIL\u003e\"\n    },\n    \"to\": {\n        \"name\": \"\u003cRECEPTION NAME\u003e\",\n        \"address\": \"\u003cRECEPTION EMAIL\u003e\"\n    },\n    \"subject\": \"Fimail - With Attachments\",\n    \"contents\": \"Lorem ipsum dolor sit amet consectetur adipisicing elit.\",\n    \"attachments: {\n        \"filename\": \"mytext.txt\",\n        \"content\": \"\u003cSTRING or BUFFER or STREAM\u003e\"\n    }\n}'\n```\n\nJika kontennya diambil dari ***buffer*** atau ***stream*** maka, kamu bisa melukan hal yang sama seperti contoh di atas ini.\n\n### 🖇 Multi Lampiran\n\nKamu juga bisa mengirim beberapa lampiran dengan cara menyusunnya ke dalam bentuk *array* seperti berikut ini.\n\n```bash\ncurl -X POST 'https://fimail.vercel.app/send' \\\n-H 'Content-Type: application/json' \\\n-d '{\n    \"from\": {\n        \"name\": \"\u003cYOUR NAME\u003e\",\n        \"address\": \"\u003cYOUR EMAIL\u003e\"\n    },\n    \"to\": {\n        \"name\": \"\u003cRECEPTION NAME\u003e\",\n        \"address\": \"\u003cRECEPTION EMAIL\u003e\"\n    },\n    \"subject\": \"Fimail - With Attachments\",\n    \"contents\": \"Lorem ipsum dolor sit amet consectetur adipisicing elit.\",\n    \"attachments: [\n        {\n            \"filename\": \"myimage.jpg\",\n            \"path\": \"https://dummyimage.com/400x400/00ffbf/000000.jpg\"\n        },\n        {\n            \"filename\": \"myimage2.jpg\",\n            \"path\": \"https://dummyimage.com/400x400/ffd000/000000.jpg\"\n        },\n        {\n            \"filename\": \"mytext.txt\",\n            \"content\": \"Hello World!\"\n        }\n    ]\n}'\n```\n\nNah, seperti itulah cara melakukan permintaan API ke Fimail untuk mengirim email.\n\nSemoga bermanfaat, terima kasih.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fferi-irawan%2Ffimail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fferi-irawan%2Ffimail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fferi-irawan%2Ffimail/lists"}