Topik ini menjelaskan cara memanggil operasi SingleSendMail untuk mengirim email tunggal. Operasi ini tidak mendukung pengiriman lampiran.
Debug
Parameter permintaan
Nama | Tipe | Diperlukan | Contoh | Deskripsi |
AccountName | String | Ya | test***@example.net | Alamat pengirim yang Anda konfigurasi di Konsol Direct Mail. |
AddressType | Integer | Ya | 1 | Jenis alamat pengirim. Nilai yang valid:
|
ReplyToAddress | String | Ya | true | Menentukan apakah akan menggunakan alamat balasan yang Anda konfigurasi di konsol. Status alamat balasan harus telah diverifikasi. Nilai yang valid adalah string "true" dan "false", bukan Nilai Boolean. |
Subject | String | Ya | Subject | Subjek email. Subjek tidak boleh melebihi 100 karakter. |
ToAddress | String | Ya | test1***@example.net | Alamat penerima. Anda dapat menentukan beberapa alamat penerima. Pisahkan dengan koma (,). Anda dapat menentukan hingga 100 alamat penerima. Grup akun didukung. |
Action | String | Tidak | SingleSendMail | Parameter yang diperlukan. Tetapkan nilainya ke SingleSendMail. |
ClickTrace | String | Tidak | 0 |
|
FromAlias | String | Tidak | Xiao Hong | Alias pengirim. Alias dapat memiliki panjang maksimal 15 karakter. Sebagai contoh, jika Anda menetapkan alias pengirim menjadi "Alice" dan alamat pengirim menjadi test***@example.net, penerima akan melihat "Alice" <test***@example.net>. |
HtmlBody | String | Tidak | body | Isi HTML email. Ukurannya dibatasi hingga 80 KB oleh kit pengembangan perangkat lunak (SDK). Catatan: HtmlBody dan TextBody menentukan isi email. Anda harus menentukan salah satunya. |
TagName | String | Tidak | test | Tag yang Anda buat di Konsol Direct Mail. Anda dapat menggunakan tag untuk mengklasifikasikan batch email dan menanyakan status pengiriman setiap batch. Jika Anda mengaktifkan pelacakan email, Anda harus menggunakan tag email. |
TextBody | String | Tidak | body | Isi teks email. Ukurannya dibatasi hingga 80 KB oleh SDK. Catatan: HtmlBody dan TextBody menentukan isi email. Anda harus menentukan salah satunya. |
ReplyAddress | String | Tidak | test2***@example.net | Alamat balasan. |
ReplyAddressAlias | String | Tidak | Xiaohong | Alias untuk alamat balasan. |
UnSubscribeLinkType | String | Tidak | default | Jenis tautan berhenti berlangganan yang akan dihasilkan. Untuk informasi selengkapnya, lihat Fitur Berhenti Berlangganan.
"google", "aol.com", "hotmail", "outlook", "ymail.com", dan sebagainya
|
UnSubscribeFilterLevel | String | Tidak | mailfrom_domain | Tingkat penyaringan. Untuk informasi selengkapnya, lihat Fitur Berhenti Berlangganan.
|
Parameter respons
Nama | Tipe | Contoh | Deskripsi |
EnvId | String | xxxxxx | ID event. |
RequestId | String | 2D086F6-8F31-4658-84C1-006DED011A85 | ID permintaan. |
Contoh
Contoh permintaan
https://dm.aliyuncs.com/?Action=SingleSendMail&AccountName=test***@example.net&AddressType=1&ReplyToAddress=true&Subject=Subject&ToAddress=test1***@example.net&<Common request parameters>Contoh respons
XML format
<SingleSendMailResponse> <EnvId>xxxxxx</EnvId> <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></SingleSendMailResponse>JSON format
{ "EnvId":"xxxxxx", "RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"}Kode kesalahan
Kode status HTTP | Kode kesalahan | Pesan kesalahan | Deskripsi |
400 | InvalidReceiverName.Malformed | Nama penerima yang ditentukan salah formatnya. | Alamat penerima dalam format yang tidak valid. Alamat harus mengandung tanda at (@). Nama akun dan nama domain hanya boleh berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). |
404 | InvalidMailAddress.NotFound | Alamat email yang ditentukan tidak ditemukan. | Alamat pengirim tidak ditemukan. |
404 | InvalidReceiver.NotFound | Penerima yang ditentukan tidak valid. | Penerima tidak ada. Periksa apakah alamat penerima valid. |
400 | InvalidToAddress | toAddress yang ditentukan salah formatnya. | Alamat penerima dalam format yang tidak valid. Alamat harus mengandung tanda at (@). Nama akun dan nama domain hanya boleh berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). |
400 | InvalidToAddress.Spam | Pengiriman email ditolak karena alamat tidak valid. | Alamat tidak valid. Periksa validitas alamat tersebut. |
400 | InvalidBody | textBody atau htmlBody yang ditentukan salah formatnya. | Format TextBody atau HtmlBody tidak valid. Tentukan ulang isinya. |
400 | InvalidSendMail.Spam | Pengiriman email ditolak oleh filter spam. | Email gagal dikirim. Periksa status pengguna terkait masalah seperti batas frekuensi terlampaui atau kuota tidak mencukupi. |
400 | InvalidMailAddressSendType.Malformed | Jenis pengiriman mailAddress yang ditentukan salah formatnya. | Jenis pengiriman tidak valid. Buka konsol untuk memeriksa jenis tersebut dan tetapkan nilainya sesuai. |
400 | InvalidMailAddressStatus.Malformed | Status mailAddress yang ditentukan salah formatnya. | Status alamat pengirim tidak valid. Periksa apakah alamat tersebut aktif atau dibekukan. |
400 | InvalidMailAddressDomain.Malformed | Nama domain mailAddress yang ditentukan tidak ada. | Nama domain dalam format yang tidak valid. Nama domain hanya boleh berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). |
400 | InvalidSubject.Malformed | Subjek yang ditentukan tidak valid. Subjek tidak boleh melebihi 100 karakter. | Subjek tidak valid. Panjangnya tidak boleh melebihi 100 karakter. |
400 | InvalidFromAlias.Malformed | fromAlias yang ditentukan salah formatnya. | Alias pengirim dalam format yang tidak valid. Panjangnya tidak boleh melebihi 15 karakter. |
400 | InvalidReplyAddressAlias.Malformed | replyAddressAlias yang ditentukan salah formatnya. | Alias untuk alamat balasan dalam format yang tidak valid. Panjangnya tidak boleh melebihi 15 karakter. |
400 | InvalidReplyAddress.Malformed | replyAddress yang ditentukan salah formatnya. | Alamat balasan dalam format yang tidak valid. Alamat harus mengandung tanda at (@). Nama akun dan nama domain hanya boleh berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). |
404 | InvalidIP.NotFound | Alamat IP yang ditentukan tidak valid. | Alamat IP yang ditentukan tidak valid. Jika Anda telah mengaktifkan perlindungan IP, pastikan alamat IP tersebut ada dalam daftar. |
400 | InvalidFromALias.Malformed | fromAlias yang ditentukan salah formatnya. | Alias pengirim tidak valid. Periksa alias pengirim. Panjangnya harus kurang dari 15 karakter. |
Untuk informasi selengkapnya tentang kode kesalahan, lihat Pusat Kesalahan.