All Products
Search

This Product

    Direct Mail:ValidateEmail

    Document Center

    Direct Mail:ValidateEmail

    Last Updated:Jul 14, 2026

    Memvalidasi alamat email.

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dm:ValidateEmail

    none

    *All Resource

    *

    		 None None

    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 waktu tunggu. Nilai default: 60 detik.

    20
    CheckGraylist

    boolean

    No

    Apakah akan memeriksa graylist. Nilai default: false. Hasilnya diberitahukan secara asinkron melalui EventBridge.

    true
    ProbeType

    string

    No

    Tipe probe. Nilai valid:

    • FULL: Mengaktifkan semua kemampuan deteksi, termasuk probing SMTP. Karena probing SMTP melibatkan koneksi jarak jauh, latensi keseluruhan tinggi. Nilai ini cocok untuk skenario yang tidak sensitif pengatur waktu respons. Setiap deteksi mengonsumsi 1 kuota Validasi alamat.

    • BASIC_ONLY: Mengaktifkan semua kemampuan deteksi kecuali probing SMTP, dengan latensi rendah. Nilai ini cocok untuk skenario yang sensitif pengatur waktu respons, seperti validasi real-time selama pendaftaran untuk memeriksa apakah alamat email adalah kotak surat sekali pakai atau alamat abnormal yang diteruskan MX, guna mencegah pendaftaran Batch oleh rantai ekonomi bawah tanah siber. Setiap deteksi mengonsumsi 1/3 kuota Validasi alamat.

    FULL

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    xxxx-xxxx-xxxx-xxxx
    Status

    string

    Status alamat email yang diperoleh dari validasi.

    Valid values:

    • VALID :

      Alamat valid.

    • CATCHALL :

      Alamat catch-all, menunjukkan bahwa domain menerima email yang dikirim ke semua alamat kotak surat yang tidak ada di bawah nama domain tersebut.

    • UNKNOWN :

      Alamat dengan status tidak diketahui.

    • INVALID :

      Alamat tidak valid.

    • DONOTMAIL :

      Alamat abnormal yang dapat dikecualikan dalam skenario pemasaran.

    VALID
    SubStatus

    string

    Sub-status alamat email yang diperoleh dari validasi, yang memberikan deskripsi detail tentang status.

    Valid values:

    • NO_DNS_ENTRIES :

      Alamat tidak valid. Tidak ada catatan DNS.

    • MISSPELLED :

      Alamat tidak valid. Alamat salah eja.

    • DOES_NOT_ACCEPT_MAIL :

      Alamat tidak valid. Server mail tidak menerima email.

    • MAILBOX_NOT_EXISTS :

      Alamat tidak valid. Kotak surat tidak ada.

    • SYSTEM_ERROR :

      Status tidak diketahui. Terjadi error sistem.

    • MX_FORWARD :

      Alamat abnormal. Penerusan MX dikonfigurasi.

    • SYNTAX_INVALID :

      Alamat tidak valid. Terdapat error sintaksis.

    • ROLE_ACCOUNT :

      Alamat abnormal. Alamat adalah akun peran, seperti role@, info@, atau contact@.

    • SMTP_CONNECT_FAILED :

      Status tidak diketahui. Gagal terhubung ke server SMTP jarak jauh.

    • DISABLED :

      Alamat tidak valid. Kotak surat telah dinonaktifkan.

    • UNSPECIFIED :

      Tidak ditentukan. Nilai ini dapat dikembalikan untuk alamat dengan status valid, catch-all, atau tidak diketahui.

    • IP_UNROUTABLE :

      Alamat tidak valid. Alamat IP server mail tidak dapat dijangkau.

    • GRAY_LIST :

      Status tidak diketahui. Alamat berada di graylist.

    • MAILBOX_FULL :

      Alamat tidak valid. Kotak surat penuh.

    • DISPOSABLE :

      Alamat abnormal. Alamat adalah kotak surat sekali pakai di daftar hitam.

    • TIMEOUT_EXCEEDED :

      Status tidak diketahui. Periode waktu tunggu yang ditentukan terlampaui.

    UNSPECIFIED
    Provider

    string

    Klasifikasi penyedia email alamat.

    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

    Apakah alamat merupakan kotak surat gratis.

    Valid values:

    • true :

      true.

    • false :

      false.

    true
    LocalPart

    string

    Bagian lokal alamat email yang diurai dari validasi sintaksis (dalam huruf kecil dan bagian tanda plus dihapus).

    xxx
    DomainPart

    string

    Bagian domain alamat email yang diurai dari validasi sintaksis (dalam 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.