全部产品
Search
文档中心

:SingleSendMail

更新时间:Nov 10, 2025

Topik ini menjelaskan cara memanggil operasi SingleSendMail untuk mengirim email tunggal. Operasi ini tidak mendukung pengiriman lampiran.

Debug

Anda dapat langsung memanggil operasi ini di OpenAPI Explorer, sehingga tidak perlu menghitung tanda tangan secara manual. Setelah pemanggilan berhasil, OpenAPI Explorer akan secara otomatis menghasilkan contoh kode kit pengembangan perangkat lunak (SDK).

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:

  • 0: akun acak

  • 1: alamat pengirim

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

  • 1: mengaktifkan pelacakan data.

  • 0 (default): menonaktifkan pelacakan data.

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.

  • Disabled: Pembuatan dinonaktifkan.

  • default: Tautan berhenti berlangganan dihasilkan untuk email dari alamat pengirim tipe batch yang dikirim ke nama domain tertentu, seperti yang mengandung kata kunci "gmail", "yahoo",

"google", "aol.com", "hotmail",

"outlook", "ymail.com", dan sebagainya

  • zh-cn: Dihasilkan untuk instrumentasi konten di masa depan.

  • en-us: Dihasilkan untuk instrumentasi konten di masa depan.

UnSubscribeFilterLevel

String

Tidak

mailfrom_domain

Tingkat penyaringan. Untuk informasi selengkapnya, lihat Fitur Berhenti Berlangganan.

  • disabled: Tidak melakukan penyaringan.

  • default: Menggunakan kebijakan default. Email batch disaring pada tingkat alamat pengirim.

  • mailfrom: Menyaring pada tingkat alamat pengirim.

  • mailfrom_domain: Menyaring pada tingkat nama domain pengirim.

  • edm_id: Menyaring pada tingkat akun.

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.