All Products
Search

This Product

    Direct Mail:ValidateEmail

    Document Center

    Direct Mail:ValidateEmail

    Last Updated:Jun 23, 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

    *全部资源

    *

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

    20
    CheckGraylist

    boolean

    No

    Apakah akan memeriksa graylist. Nilai default: false. Hasil dikirim sebagai notifikasi asinkron melalui EventBridge.

    true
    ProbeType

    string

    No

    Tipe deteksi. Nilai valid:

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

    • BASIC_ONLY: Mengaktifkan semua kemampuan deteksi kecuali probing SMTP, dengan latensi rendah. Ini cocok untuk skenario yang sensitif terhadap pengatur waktu, seperti validasi real-time saat pendaftaran untuk memeriksa apakah alamat email adalah email sekali pakai atau alamat tidak normal seperti penerusan MX, guna mencegah pendaftaran massal oleh aktor jahat. 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 CatchAll, menunjukkan domain menerima email yang dikirim ke semua alamat kotak surat yang tidak ada di bawah domain ini.

    • UNKNOWN :

      Alamat dengan status tidak diketahui.

    • INVALID :

      Alamat tidak valid.

    • DONOTMAIL :

      Alamat tidak normal, dapat dikecualikan dalam skenario pemasaran.

    VALID
    SubStatus

    string

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

    Valid values:

    • NO_DNS_ENTRIES :

      Alamat tidak valid, tidak ada catatan DNS.

    • MISSPELLED :

      Alamat tidak valid, salah eja.

    • DOES_NOT_ACCEPT_MAIL :

      Alamat tidak valid, server mail tidak menerima mail.

    • MAILBOX_NOT_EXISTS :

      Alamat tidak valid, kotak surat tidak ada.

    • SYSTEM_ERROR :

      Status tidak diketahui, error sistem.

    • MX_FORWARD :

      Alamat tidak normal, penerusan MX.

    • SYNTAX_INVALID :

      Alamat tidak valid, error sintaks.

    • ROLE_ACCOUNT :

      Alamat tidak normal, akun peran, seperti role@, info@, contact@, dll.

    • SMTP_CONNECT_FAILED :

      Status tidak diketahui, gagal terhubung ke server SMTP jarak jauh.

    • DISABLED :

      Alamat tidak valid, kotak surat telah dinonaktifkan.

    • UNSPECIFIED :

      Tidak ditentukan, dapat dikembalikan untuk status Valid, CatchAll, atau Unknown.

    • IP_UNROUTABLE :

      Alamat tidak valid, IP server mail tidak dapat dijangkau.

    • GRAY_LIST :

      Status tidak diketahui, graylist.

    • MAILBOX_FULL :

      Alamat tidak valid, kotak surat penuh.

    • DISPOSABLE :

      Alamat tidak normal, email sekali pakai, daftar blokir.

    • TIMEOUT_EXCEEDED :

      Status tidak diketahui, melebihi pengatur waktu yang ditentukan.

    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 email gratis.

    Valid values:

    • true :

      true.

    • false :

      false.

    true
    LocalPart

    string

    Bagian lokal alamat email yang diurai dari validasi sintaks (huruf kecil dengan bagian tanda plus dihapus).

    xxx
    DomainPart

    string

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