Tüm Ürünler
Search
Belge Merkezi

:SingleSendMail

Son Güncelleme:Oct 04, 2026

Bu konu, tek bir e-posta göndermek için SingleSendMail işleminin nasıl çağrılacağını açıklar. SingleSendMail işlemi ek dosya gönderimini desteklemez.

Hata Ayıklama

Bu işlemi doğrudan OpenAPI Explorer'da çağırabilirsiniz. Bu sayede imza hesaplama zahmetinden kurtulursunuz. Başarılı bir çağrıdan sonra OpenAPI Explorer otomatik olarak SDK kod örnekleri oluşturur.

İstek parametreleri

Ad

Tür

Zorunlu

Örnek

Açıklama

AccountName

String

Evet

test***@example.net

Direct Mail konsolunda yapılandırdığınız gönderen adresi.

AddressType

Integer

Evet

1

Gönderen adresinin türü. Geçerli değerler:

  • 0: rastgele hesap

  • 1: gönderen adresi

ReplyToAddress

String

Evet

true

Konsolda yapılandırdığınız yanıtla adresinin kullanılıp kullanılmayacağını belirtir. Yanıtla adresinin durumu doğrulanmış olmalıdır. Geçerli değerler Boolean değil, "true" ve "false" dizeleridir.

Subject

String

Evet

Konu

E-posta konusu. Konu 100 karakterden uzun olamaz.

ToAddress

String

Evet

test1***@example.net

Alıcı adresi. Birden çok alıcı adresi belirtebilirsiniz. Adresleri virgül (,) ile ayırın. En fazla 100 alıcı adresi belirtebilirsiniz. Hesap grupları desteklenir.

Action

String

Hayır

SingleSendMail

Zorunlu parametre. Değeri SingleSendMail olarak ayarlayın.

ClickTrace

String

Hayır

0

  • 1: veri izlemeyi etkinleştirir.

  • 0 (varsayılan): veri izlemeyi devre dışı bırakır.

FromAlias

String

Hayır

Xiao Hong

Gönderen takma adı. Takma ad en fazla 15 karakter uzunluğunda olabilir.

Örneğin, gönderen takma adını "Alice" ve gönderen adresini test@example.net olarak ayarlarsanız alıcı "Alice" <test@example.net> görür.

HtmlBody

String

Hayır

body

E-postanın HTML gövdesi. Boyut SDK tarafından 80 KB ile sınırlıdır. Not: HtmlBody ve TextBody e-postanın içeriğini belirtir. Bunlardan birini belirtmeniz gerekir.

TagName

String

Hayır

test

Direct Mail konsolunda oluşturduğunuz etiket. E-posta toplu işlerini sınıflandırmak ve her toplu işin gönderim durumunu sorgulamak için etiketleri kullanabilirsiniz. E-posta izlemeyi etkinleştirirseniz bir e-posta etiketi kullanmanız gerekir.

TextBody

String

Hayır

body

E-postanın metin gövdesi. Boyut SDK tarafından 80 KB ile sınırlıdır. Not: HtmlBody ve TextBody e-postanın içeriğini belirtir. Bunlardan birini belirtmeniz gerekir.

ReplyAddress

String

Hayır

test2***@example.net

Yanıtla adresi.

ReplyAddressAlias

String

Hayır

Xiaohong

Yanıtla adresi için takma ad.

UnSubscribeLinkType

String

Hayır

default

Oluşturulacak abonelikten çıkış bağlantısının türü. Daha fazla bilgi için bkz. Abonelikten çıkma özelliği.

  • Disabled: Oluşturma devre dışı bırakılır.

  • default: Belirli alan adlarına (örneğin "gmail", "yahoo" anahtar sözcüklerini içerenler) gönderilen toplu türdeki gönderen adreslerine sahip e-postalar için bir abonelikten çıkış bağlantısı oluşturulur,

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

"outlook", "ymail.com" vb.

  • zh-cn: Gelecekteki içerik enstrümantasyonu için oluşturulur.

  • en-us: Gelecekteki içerik enstrümantasyonu için oluşturulur.

UnSubscribeFilterLevel

String

Hayır

mailfrom_domain

Filtreleme düzeyi. Daha fazla bilgi için bkz. Abonelikten çıkma özelliği.

  • disabled: Filtreleme yapmaz.

  • default: Varsayılan ilkeyi kullanır. Toplu e-postalar gönderen adresi düzeyinde filtrelenir.

  • mailfrom: Gönderen adresi düzeyinde filtreler.

  • mailfrom_domain: Gönderen alan adı düzeyinde filtreler.

  • edm_id: Hesap düzeyinde filtreler.

Yanıt parametreleri


Ad


Tür


Örnek


Açıklama


EnvId


String


xxxxxx


Olay kimliği.


RequestId


String


2D086F6-8F31-4658-84C1-006DED011A85


İstek kimliği.

Örnekler

İstek örneği

https://dm.aliyuncs.com/?Action=SingleSendMail&AccountName=test***@example.net&AddressType=1&ReplyToAddress=true&Subject=Subject&ToAddress=test1***@example.net&<Common request parameters>

Yanıt örnekleri

XML biçimi

<SingleSendMailResponse>      <EnvId>xxxxxx</EnvId>      <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></SingleSendMailResponse>

JSON biçimi

{    "EnvId":"xxxxxx",    "RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"}

Hata kodları


HTTP durum kodu


Hata kodu


Hata iletisi


Açıklama


400


InvalidReceiverName.Malformed


Belirtilen alıcı adı hatalı biçimlendirilmiş.


Alıcı adresi geçersiz biçimde. Adres @ işareti içermelidir. Hesap adı ve alan adı yalnızca harf, rakam, alt çizgi (_), tire (-) ve nokta (.) içerebilir.


404


InvalidMailAddress.NotFound


Belirtilen posta adresi bulunamadı.


Gönderen adresi bulunamadı.


404


InvalidReceiver.NotFound


Belirtilen alıcı geçersiz.


Alıcı mevcut değil. Alıcı adresinin geçerli olup olmadığını kontrol edin.


400


InvalidToAddress


Belirtilen toAddress hatalı biçimlendirilmiş.


Alıcı adresi geçersiz biçimde. Adres @ işareti içermelidir. Hesap adı ve alan adı yalnızca harf, rakam, alt çizgi (_), tire (-) ve nokta (.) içerebilir.


400


InvalidToAddress.Spam


Geçersiz adres nedeniyle gönderim reddedildi.


Adres geçersiz. Adresin geçerliliğini kontrol edin.


400


InvalidBody


Belirtilen textBody veya htmlBody hatalı biçimlendirilmiş.


TextBody veya HtmlBody biçimi geçersiz. İçeriği yeniden belirtin.


400


InvalidSendMail.Spam


Spam filtresi tarafından gönderim reddedildi.


E-posta gönderilemedi. Aşılan frekans sınırı veya yetersiz kota gibi sorunlar için kullanıcı durumunu kontrol edin.


400


InvalidMailAddressSendType.Malformed


Belirtilen mailAddress sendType hatalı biçimlendirilmiş.


Gönderim türü geçersiz. Konsola giderek türü kontrol edin ve değeri buna göre ayarlayın.


400


InvalidMailAddressStatus.Malformed


Belirtilen mailAddress durumu hatalı biçimlendirilmiş.


Gönderen adresinin durumu geçersiz. Adresin etkin mi yoksa dondurulmuş mu olduğunu kontrol edin.


400


InvalidMailAddressDomain.Malformed


Belirtilen mailAddress alanı mevcut değil.


Alan adı geçersiz biçimde. Yalnızca harf, rakam, alt çizgi (_), tire (-) ve nokta (.) içerebilir.


400


InvalidSubject.Malformed


Belirtilen konu geçersiz. 100 karakteri aşmamalıdır.


Konu geçersiz. Uzunluğu 100 karakteri aşamaz.


400


InvalidFromAlias.Malformed


Belirtilen fromAlias hatalı biçimlendirilmiş.


Gönderen takma adı geçersiz biçimde. Uzunluğu 15 karakteri aşamaz.


400


InvalidReplyAddressAlias.Malformed


Belirtilen replyAddressAlias hatalı biçimlendirilmiş.


Yanıtla adresi için takma ad geçersiz biçimde. Uzunluğu 15 karakteri aşamaz.


400


InvalidReplyAddress.Malformed


Belirtilen replyAddress hatalı biçimlendirilmiş.


Yanıtla adresi geçersiz biçimde. Adres @ işareti içermelidir. Hesap adı ve alan adı yalnızca harf, rakam, alt çizgi (_), tire (-) ve nokta (.) içerebilir.


404


InvalidIP.NotFound


Belirtilen IP adresi geçersiz.


Belirtilen IP adresi geçersiz. IP korumasını etkinleştirdiyseniz IP adresinin listede olduğundan emin olun.


400


InvalidFromALias.Malformed


Belirtilen fromAlias hatalı biçimlendirilmiş.


Gönderen takma adı geçersiz. Gönderen takma adını kontrol edin. Uzunluğu 15 karakterden az olmalıdır.

Hata kodları hakkında daha fazla bilgi için bkz. Hata Merkezi.