Mengirim Email menggunakan API Key

Outgoing Email

Vimanamail memiliki kemampuan untuk mengirimkan email menggunakan API (Application Programming Interface) berbasis protocol HTTPS dengan JSON REST API.

Sebelum memulai, pastikan beberapa hal berikut:

  • Fungsi SMTP Outgoing sudah enable dan memiliki API Key sebagai credential yang wajib dimiiki
  • IP Pengirim sudah masuk ke daftar Allowlist (biasanya merupakan IP server tempat aplikasi berada)

Service location and request structure

HTTP Method/URI:

Method: POST
https://api.defend.my.id/vimana.php

Request Body:

{
	"apikey":"apikey",
	"emailfromname":"Email Sender Name",
	"emailfrom":"email@sender.com",
	"emailtoname":["Email Recipient Name"],
	"emailto":["email@recipient.com"],
	"emailsubject":"Email Subject",
	"emailbody":"Email Body",
	"attachmentname":["filename.jpg"],
	"attachmentfile":["base64code"]
}
NameData TypeDescription
apikeyStringApi key yang didapat dari vimana console
emailfromnameStringNama pengirim email
emailfromStringAlamat pengirim email
emailtonameArrayNama penerima email
emailtoArrayAlamat penerima email
emailsubjectStringSubject email
emailbodyStringIsi email, mendukung format html/plain text
attachmentnameArrayNama file attachment (optional)
attachmentfileArrayCode base64 file attachment (optional)

Successful response

{
	"errlog":0,
	"errdesc":”success”
}

Failed response

CodeDescription
Api_100Parameter request body tidak valid
Api_101Format alamat email tidak valid
Api_102Terjadi kesalahan pada server
Api_103Error parsing parameter
Api_104Filter SMTP: SenderIPRejected, SenderDomainRejected, OverQuotaDaily, OverQuotaMonthly, AttacmentSizeExceeded, EmailSizeExceeded