ValidateEmail - Direct Mail

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
Email	string	Yes	Alamat email yang akan divalidasi.	xxx@yyy.com
Timeout	integer	No	Periode timeout. Nilai default-nya adalah 60 detik.	20
CheckGraylist	boolean	No	Menentukan apakah akan memeriksa graylist. Nilai default-nya adalah false. Hasilnya dikirim melalui pesan notifikasi asinkron dari EventBridge.	true

Elemen respons

Element	Type	Description	Example
	object	Skema Respons
RequestId	string	ID permintaan.	xxxx-xxxx-xxxx-xxxx
Status	string	Status validasi alamat email. Valid values: VALID : Alamat tersebut valid. CATCHALL : Alamat tersebut merupakan alamat catch-all. Ini menunjukkan bahwa domain menerima email yang dikirim ke kotak surat apa pun yang tidak ada di domain tersebut. UNKNOWN : Status alamat tidak diketahui. INVALID : Alamat tersebut tidak valid. DONOTMAIL : Alamat tersebut tidak normal. Anda dapat menghapus alamat jenis ini dalam skenario pemasaran.	VALID
SubStatus	string	Status validasi detail alamat email. Ini memberikan informasi lebih lanjut mengenai Status. Valid values: NO_DNS_ENTRIES : Alamat tidak valid. Tidak ditemukan rekaman DNS. MISSPELLED : Alamat tidak valid. Alamat tersebut salah eja. MAILBOX_NOT_EXISTS : Alamat tidak valid. Kotak surat tidak ada. SYSTEM_ERROR : Status tidak diketahui. Terjadi error sistem. SYNTAX_INVALID : Alamat tidak valid. Terdapat error sintaksis. ROLE_ACCOUNT : Alamat tidak normal. Alamat tersebut merupakan akun peran (role account). SMTP_CONNECT_FAILED : Status tidak diketahui. Koneksi ke server SMTP penerima gagal. DISABLED : Alamat tidak valid. Kotak surat dinonaktifkan. UNSPECIFIED : Tidak ada detail spesifik. Sub-status ini dapat dikembalikan untuk status VALID, CATCHALL, atau UNKNOWN. IP_UNROUTABLE : Alamat tidak valid. Alamat IP server email tidak dapat dijangkau. MAILBOX_FULL : Alamat tidak valid. Kotak surat penuh. DISPOSABLE : Alamat tidak normal. Alamat tersebut merupakan alamat email sekali pakai (disposable email address). TIMEOUT_EXCEEDED : Status tidak diketahui. Periode timeout yang ditentukan telah terlampaui.	UNSPECIFIED
Provider	string	Penyedia layanan email dari alamat tersebut. Valid values: Others : Lainnya Yahoo : Yahoo Gmx : Gmx MailDotCom : MailDotCom Tencent : Tencent Gmail : Gmail Outlook : Outlook Zoho : Zoho Proton : Proton Netease : Netease Icloud : Icloud Webde : Webde	Gmail
IsFreeMail	boolean	Menunjukkan apakah alamat tersebut berasal dari layanan email gratis. Valid values: true : true false : false	true
LocalPart	string	Bagian lokal dari alamat email yang diurai dari pemeriksaan sintaksis. Bagian lokal diubah menjadi huruf kecil dan konten setelah tanda plus (+) dihapus.	xxx
DomainPart	string	Bagian domain dari alamat email yang diurai dari pemeriksaan sintaksis. Bagian domain diubah menjadi huruf kecil.	yyy.com

Contoh

Respons sukses

JSONformat

{
  "RequestId": "xxxx-xxxx-xxxx-xxxx",
  "Status": "VALID",
  "SubStatus": "UNSPECIFIED",
  "Provider": "Gmail",
  "IsFreeMail": true,
  "LocalPart": "xxx",
  "DomainPart": "yyy.com"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.