Tüm Ürünler
Search

Bu Ürün

    :SingleSendMail

    Belge Merkezi

    :SingleSendMail

    Son Güncelleme:Sep 30, 2026

    Tek bir e-posta gönderir.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dm:SingleSendMail

    none

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    AccountName

    string

    Yes

    Yönetim konsolunda yapılandırılan gönderen adresi.

    test***@example.net
    AddressType

    integer

    Yes

    Adres türü. Geçerli değerler:

    • 0: rastgele hesap

    • 1: gönderen adresi

    1
    TagName

    string

    No

    DirectMail konsolunda oluşturulan etiket. Etiketler, e-posta toplu gönderimlerini kategorize etmek için kullanılır. Her bir toplu gönderimin gönderim durumunu etikete göre sorgulayabilirsiniz. E-posta izleme özelliği etkinleştirilmişse, e-posta gönderirken bir e-posta etiketi kullanmanız gerekir. Değer 1 ila 128 karakter uzunluğunda olmalı ve harf, rakam, alt çizgi (_) ve tire (-) içerebilir.

    test
    ReplyToAddress

    boolean

    Yes

    Yönetim konsolunda yapılandırılan yanıt adresinin (adresin doğrulanmış olması gerekir) kullanılıp kullanılmayacağını belirtir. Geçerli değerler: true veya false.

    true
    ToAddress

    string

    Yes

    Hedef adres. Virgülle ayrılmış birden fazla e-posta adresi belirtebilirsiniz. En fazla 100 adres desteklenir (posta listeleri desteklenir).

    test1***@example.net
    Subject

    string

    Yes

    E-posta konusu. Değer 256 karakteri aşamaz.

    Subject
    HtmlBody

    string

    No

    E-postanın HTML gövdesi.

    Not: HtmlBody ve TextBody farklı e-posta içeriği türleri için kullanılır. Bunlardan birini belirtmeniz gerekir.

    • URL tabanlı parametre aktarımı için boyut sınırı yaklaşık 80 KB'dir.

    • Yeni SDK ile gövde tabanlı parametre aktarımı için boyut sınırı yaklaşık 8 MB'dir (Java 1.4.0 veya sonraki sürümler, Python3 1.4.0 veya sonraki sürümler, PHP 1.4.0 veya sonraki sürümler).

    body
    TextBody

    string

    No

    E-postanın metin gövdesi.

    Not: HtmlBody ve TextBody farklı e-posta içeriği türleri için kullanılır. Bunlardan birini belirtmeniz gerekir.

    • URL tabanlı parametre aktarımı için boyut sınırı yaklaşık 80 KB'dir.

    • Yeni SDK ile gövde tabanlı parametre aktarımı için boyut sınırı yaklaşık 8 MB'dir (Java 1.4.0 veya sonraki sürümler, Python3 1.4.0 veya sonraki sürümler, PHP 1.4.0 veya sonraki sürümler).

    body
    FromAlias

    string

    No

    Gönderen takma adı. Değer 15 karakteri aşamaz.

    Örneğin, gönderen takma adı "Jane" ve gönderen adresi test***@example.net olarak ayarlanmışsa, alıcı gönderen adresini "Jane" test***@example.net olarak görür.

    Jane
    ReplyAddress

    string

    No

    Yanıt adresi.

    test2***@example.net
    ReplyAddressAlias

    string

    No

    Yanıt adresi takma adı.

    Jane
    ClickTrace

    string

    No

    Veri izlemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • 1: Veri izlemeyi etkinleştir.

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

    0
    UnSubscribeLinkType

    string

    No

    Abonelikten çıkış bağlantısı türü. Geçerli değerler:

    • disabled: Abonelikten çıkış bağlantısı oluşturulmaz.

    • default: Varsayılan ilke kullanılır. Toplu gönderim türündeki gönderen adreslerinden "gmail", "yahoo", "google", "aol.com", "hotmail", "outlook" veya "ymail.com" gibi belirli anahtar kelimeler içeren alan adlarına e-posta gönderildiğinde bir abonelikten çıkış bağlantısı oluşturulur. Daha fazla bilgi için Abonelikten çıkış bağlantısı oluşturma ve filtreleme mekanizması bölümüne bakın.

    Görüntüleme dili, alıcının tarayıcı ayarlarına göre otomatik olarak algılanır.

    default
    UnSubscribeFilterLevel

    string

    No

    Filtreleme düzeyi. Daha fazla bilgi için Abonelikten çıkış bağlantısı oluşturma ve filtreleme mekanizması bölümüne bakın.

    Geçerli değerler:

    • disabled: Filtreleme uygulanmaz.

    • default: Varsayılan ilke kullanılır. Toplu gönderim adresleri, gönderen adresi düzeyinde filtreleme kullanır.

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

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

    • edm_id: Hesap düzeyinde filtreleme.

    mailfrom_domain
    Headers

    string

    No

    E-posta üst bilgisi ayarları.

    Hem standart hem de standart olmayan alanlar, standartta tanımlanan üst bilgiler için sözdizimi gereksinimlerine uymalıdır. API aracılığıyla e-posta gönderirken headers alanı üzerinden en fazla 10 üst bilgi aktarılabilir. Bu sınırı aşan üst bilgiler yoksayılır. SMTP'nin böyle bir sınırı yoktur.

    1. Standart alanlar

    Message-ID, List-Unsubscribe, List-Unsubscribe-Post

    Standart alanlar, e-posta üst bilgisindeki orijinal değerlerin üzerine yazar.

    1. Standart olmayan alanlar

    Büyük/küçük harfe duyarlı değildir.

    a. X-User- ön ekine sahip alanlar (EventBridge veya Message Service MNS'ye aktarılmaz. Bu yalnızca API'ye özgü bir gereksinimdir. SMTP herhangi bir özel alana izin verir.)

    b. X-User-Notify- ön ekine sahip alanlar (EventBridge ve Message Service MNS'ye aktarılır. Hem API hem de SMTP desteklenir.)

    EventBridge veya MNS'ye aktarıldığında, bu alanlar header alanı altında yer alır.

    { "Message-ID": "", "X-User-UID1": "UID-1-000001", "X-User-UID2": "UID-2-000001", "X-User-Notify-UID1": "UID-3-000001", "X-User-Notify-UID2": "UID-4-000001" }
    IpPoolId

    string

    No

    Özel IP adresi havuzunun kimliği. Özel IP adresleri satın alan kullanıcılar, bu e-posta için giden IP adresini belirtmek üzere bu parametreyi kullanabilir. Daha fazla bilgi için Özel IP bölümüne bakın.

    e4xxxxxe-4xx0-4xx3-8xxa-74cxxxxx1cef
    Attachments

    array<object>

    No

    Yalnızca yeni SDK kullanılırken desteklenir. OpenAPI veya imza mekanizması yöntemleri üzerinden desteklenmez. Daha fazla bilgi için SDK üzerinden ekli e-postaları nasıl gönderirim? bölümüne bakın.

    object

    No

    Yalnızca yeni SDK kullanılırken desteklenir. OpenAPI veya imza mekanizması yöntemleri üzerinden desteklenmez.

    AttachmentName

    string

    No

    Yalnızca yeni SDK kullanılırken desteklenir. OpenAPI veya imza mekanizması yöntemleri üzerinden desteklenmez.

    test.txt
    AttachmentUrl

    string

    No

    Yalnızca yeni SDK kullanılırken desteklenir. OpenAPI veya imza mekanizması yöntemleri üzerinden desteklenmez.

    C:\Users\Downloads\test.txt
    Template

    object

    No

    Şablon tabanlı gönderim için şablon bilgileri.

    Şablonla gönderim yaparken HtmlBody ve TextBody değerleri yoksayılır.

    TemplateId

    string

    No

    Şablon kimliği.

    xxx
    TemplateData

    object

    No

    Şablon değişkenleri ve değerleri.

    string

    No

    Şablon değişkeni parametresi ve değeri.

    { "name": "Tom", "age": "22" }
    BccAddress

    string

    No

    • E-posta için BCC (gizli karbon kopya) alıcı listesini belirtir.

    • Sistem, her BCC adresine ana e-posta içeriğiyle aynı bir kopya gönderir. BCC bilgileri hiçbir alıcı (ToAddress ve BccAddress dahil) tarafından görülemez.

    • BCC alıcılarının gizliliğini korumak için, BCC e-postalarında e-posta izleme özellikleri varsayılan olarak devre dışıdır. Bu, sistemin BCC e-postaları için açılma oranları veya tıklama oranları gibi davranışsal verileri kaydetmediği anlamına gelir. Ancak gönderim hacmi, gönderim ayrıntıları ve gönderim durumu istatistikleri için faturalandırma normal e-postalarla tutarlı kalır.

    • Gönderim başına en fazla 2 BCC alıcısı belirtilebilir.

    Not: SingleSendMail işlemi Cc (karbon kopya) alanını desteklemez. Bu özelliğe ihtiyacınız varsa SMTP kullanın.

    1@example.com,2@example.com
    DomainAuth

    boolean

    No

    Alan adı düzeyinde kimlik doğrulamanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true

    • false

    Bu parametreyi yalnızca alan adı düzeyinde kimlik doğrulama için kullanın. Gönderen adresi düzeyinde kimlik doğrulama için dikkate almayın.

    1. Konsolda domain-auth-created-by-system@example.com adresini oluşturun. @ işaretinden önceki ön eki değiştirmeden bırakın ve son ek olarak kendi alan adınızı kullanın.

    API senaryosu

    AccountName değerini alan adı için özel bir gönderen adresi olarak ayarlayın. Alıcı, gönderen olarak özel gönderen adresini görür.

    SMTP senaryosu

    a. ModifyPWByDomain işlemi aracılığıyla alan adı parolasını ayarlayın.

    b. Alan adını ve yapılandırılan parolayı kullanarak kimlik doğrulaması yapın. Gerçek gönderen (mailfrom) olarak user@example.com gibi özel bir adres aktarın. Alıcı, gönderen olarak user@example.com adresini görür.

    true

    Response elements

    Element

    Type

    Description

    Example

    object

    EnvId

    string

    Olay kimliği.

    600000xxxxxxxxxx642
    RequestId

    string

    İstek kimliği.

    2D086F6-xxxx-xxxx-xxxx-006DED011A85

    Examples

    Success response

    JSON format

    {
  "EnvId": "600000xxxxxxxxxx642",
  "RequestId": "2D086F6-xxxx-xxxx-xxxx-006DED011A85"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidReceiverName.Malformed The format of the receiver name is invalid. It must contain the @ sign. The domain must only contain numbers, letters, underscores, minus signs, and periods. The account name must only contain numbers, letters, underscores, minus signs, and periods.
    404 InvalidMailAddress.NotFound The specified mail address is not found.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.