:Veri gönderme API'leri

Ad

Tür

Gerekli

Açıklama

Action

Dize

Evet

Zorunlu bir parametredir. Değeri SenderStatisticsByTagNameAndBatchID olarak ayarlayın.

AccountName

Dize

Hayır

Gönderen adresi. Bu parametreyi belirtmezseniz tüm gönderen adreslerine ait veriler döndürülür.

TagName

Dize

Hayır

E-posta etiketi. Bu parametreyi belirtmezseniz tüm etiketlere ait veriler döndürülür.

StartTime

Dize

Evet

Sorgulanacak zaman aralığının başlangıcı. Zaman son 30 gün içinde olmalıdır. Biçim yyyy-AA-gg şeklindedir.

EndTime

Dize

Evet

Sorgulanacak zaman aralığının bitişi. Zaman aralığı 7 günü aşamaz. Biçim yyyy-AA-gg şeklindedir.

Ad

Tür

Açıklama

TotalCount

Tamsayı

Kayıt sayısı toplamı.

Data

Dizi

Veri kayıtları.

Ad

Tür

Açıklama

createTime

Dize

Kaydın oluşturulma zamanı.

faildCount

Dize

Başarısızlık sayısı

requestCount

Dize

Gönderim isteği sayısı.

succeededPercent

Dize

Başarı oranı

successCount

Dize

Başarı sayısı

unavailableCount

Dize

Geçersiz e-posta sayısı.

unavailablePercent

Dize

Etkisizlik

Hata kodu

Açıklama

HTTP durum kodu

Anlamı

InvalidDate.Malformed

Zaman biçimi geçersiz.

InvalidDate.NotFound

Zaman belirtilmemiş.

InvalidStartTime.Malformed

Başlangıç zamanının biçimi geçersiz.

InvalidBetweenTime.Malformed

Zaman aralığı izin verilen sınırı aşıyor.

InvalidMailAddressName.Malformed

Gönderen adresi geçersiz.

InvalidMailAddress.NotFound

Gönderen adresi mevcut değil.

InvalidTagName.Malformed

E-posta etiketi geçersiz.

InvalidYear.Malformed

Belirtilen yıl geçersiz.

InternalError

Bilinmeyen bir hata oluştu.

Ad

Tür

Gerekli

Açıklama

Action

Dize

Evet

Zorunlu bir parametredir. Değeri GetTrackListByMailFromAndTagName olarak ayarlayın.

AccountName

Dize

Hayır

Gönderen adresi. Bu parametreyi belirtmezseniz tüm gönderen adreslerine ait veriler döndürülür. TagName belirtiyorsanız bu parametre gereklidir.

TagName

Dize

Hayır

E-posta etiketi. Bu parametreyi belirtmezseniz tüm etiketlere ait veriler döndürülür.

StartTime

Dize

Evet

Sorgulanacak zaman aralığının başlangıcı. Zaman son 30 gün içinde olmalıdır. Biçim yyyy-AA-gg şeklindedir.

EndTime

Dize

Evet

Sorgulanacak zaman aralığının bitişi. Zaman aralığı 15 günü aşamaz. Biçim yyyy-AA-gg şeklindedir.

Total

Dize

Hayır

Bu parametre kullanımdan kaldırılmıştır.

Offset

Dize

Evet

İlk sorgu için değeri 0, sonraki sorgular için 1 olarak ayarlayın. 1 değeri, kronolojik sıraya göre sayfalı sorguyu gösterir. Bu parametre kullanımdan kaldırılmıştır.

PageSize

Dize

Hayır

Sayfa boyutu

OffsetCreateTime

Dize

Hayır

Sayfalama için kullanılır. İlk sorguda bu parametreyi ayarlamayın. Sonraki sorgular için önceki yanıttaki sOffsetCreateTime değerine ayarlayın. Bu parametre kullanımdan kaldırılmıştır.

OffsetCreateTimeDesc

Dize

Hayır

Bu parametre kullanımdan kaldırılmıştır.

PageNumber

Dize

Hayır

Sayfa numarası.

Ad

Tür

Açıklama

OffsetCreateTime

Dize

Sayfalama için kullanılır.

OffsetCreateTimeDesc

Dize

Bu parametre kullanımdan kaldırılmıştır.

PageNo

Tamsayı

Sayfa numarası.

PageSize

Tamsayı

Sayfa boyutu

TrackList

Dizi

E-posta izleme kayıtları.

Total

Tamsayı

Bu parametre kullanımdan kaldırılmıştır.

Ad

Tür

Açıklama

CreateTime

Dize

Kaydın oluşturulma zamanı.

RcptClickCount

Dize

Toplam tıklama sayısı.

RcptOpenCount

Dize

Toplam açılma sayısı.

RcptUniqueClickCount

Dize

Benzersiz tıklama sayısı.

RcptUniqueClickRate

Dize

Benzersiz tıklama oranı.

RcptUniqueOpenCount

Dize

Benzersiz açılma sayısı.

RcptUniqueOpenRate

Dize

Benzersiz açılma oranı.

TotalNumber

Dize

Toplam

Hata kodu

Açıklama

HTTP durum kodu

Anlamı

InvalidDate.Malformed

Zaman biçimi geçersiz.

InvalidDate.NotFound

Zaman belirtilmemiş.

InvalidStartTime.Malformed

Başlangıç zamanının biçimi geçersiz.

InvalidBetweenTime.Malformed

Zaman aralığı izin verilen sınırı aşıyor.

InvalidMailAddressName.Malformed

Gönderen adresi geçersiz.

InvalidMailAddress.NotFound

Gönderen adresi mevcut değil.

InvalidTagName.Malformed

E-posta etiketi geçersiz.

InvalidYear.Malformed

Belirtilen yıl geçersiz.

InternalError

Bilinmeyen bir hata oluştu.

Ad

Tür

Gerekli

Açıklama

Action

Dize

Evet

Zorunlu bir parametredir. Değeri GetTrackList olarak ayarlayın.

StartTime

Dize

Evet

Sorgulanacak zaman aralığının başlangıcı. Zaman son 30 gün içinde olmalıdır. Biçim yyyy-AA-gg şeklindedir.

EndTime

Dize

Evet

Sorgulanacak zaman aralığının bitişi. Zaman aralığı 7 günü aşamaz. Biçim yyyy-AA-gg şeklindedir.

Total

Dize

Hayır

Bu parametre kullanımdan kaldırılmıştır.

Offset

Dize

Hayır

İlk sorgu için değeri 0, sonraki sorgular için 1 olarak ayarlayın. 1 değeri, kronolojik sıraya göre sayfalı sorguyu gösterir. Bu parametre kullanımdan kaldırılmıştır.

OffsetCreateTime

Dize

Hayır

Sayfalama için kullanılır.

OffsetCreateTimeDesc

Dize

Hayır

Bu parametre kullanımdan kaldırılmıştır.

PageNumber

Dize

Hayır

Sayfa numarası.

PageSize

Dize

Hayır

Her sayfada yer alan kayıt sayısı.

Ad

Tür

Açıklama

OffsetCreateTime

Dize

Sayfalama için kullanılır.

OffsetCreateTimeDesc

Dize

Bu parametre kullanımdan kaldırılmıştır.

Total

Tamsayı

Bu parametre kullanımdan kaldırılmıştır.

PageNo

Tamsayı

Sayfa numarası.

PageSize

Tamsayı

Her sayfada yer alan kayıt sayısı.

Data

Dizi

E-posta izleme kayıtları.

Ad

Tür

Açıklama

CreateTime

Dize

Kaydın oluşturulma zamanı.

RcptClickCount

Dize

Toplam tıklama sayısı.

RcptOpenCount

Dize

Toplam açılma sayısı.

RcptUniqueClickCount

Dize

Benzersiz tıklama sayısı.

RcptUniqueClickRate

Dize

Benzersiz tıklama oranı.

RcptUniqueOpenCount

Dize

Benzersiz açılma sayısı.

RcptUniqueOpenRate

Dize

Benzersiz açılma oranı.

TotalNumber

Dize

Toplam

RcptClickRate

Dize

Tıklama oranı.

RcptOpenRate

Dize

Açılma oranı.

Hata kodu

Açıklama

HTTP durum kodu

Anlamı

InvalidDate.Malformed

Zaman biçimi geçersiz.

InvalidDate.NotFound

Zaman belirtilmemiş.

InvalidStartTime.Malformed

Başlangıç zamanının biçimi geçersiz.

InvalidBetweenTime.Malformed

Zaman aralığı izin verilen sınırı aşıyor.

InvalidMailAddressName.Malformed

Gönderen adresi geçersiz.

InvalidMailAddress.NotFound

Gönderen adresi mevcut değil.

InvalidTagName.Malformed

E-posta etiketi geçersiz.

InvalidYear.Malformed

Belirtilen yıl geçersiz.

InternalError

Bilinmeyen bir hata oluştu.

Ad

Tür

Gerekli

Açıklama

Action

Dize

Evet

Zorunlu bir parametredir. Değeri QueryInvalidAddress olarak ayarlayın.

StartTime

Dize

Hayır

Sorgulanacak zaman aralığının başlangıcı. Zaman son 30 gün içinde olmalıdır. Biçim yyyy-AA-gg şeklindedir.

EndTime

Dize

Hayır

Sorgulanacak zaman aralığının bitişi. Zaman aralığı 30 günü aşamaz. Biçim yyyy-AA-gg şeklindedir.

KeyWord

Dize

Hayır

Sorgu için bir anahtar sözcük. Bu parametreyi belirtmezseniz tüm geçersiz adresler döndürülür.

Length

Tamsayı

Hayır

Her istekte döndürülecek kayıt sayısı.

NextStart

Dize

Hayır

Sorgunun başlangıç konumu.

Ad

Tür

Açıklama

TotalCount

Tamsayı

Kayıt sayısı toplamı.

Data

Dizi

Veriler.

NextStart

Dize

Sonraki sorgunun başlangıç konumu.

Ad

Tür

Açıklama

mailDetail

Liste

Kayıtlar.

Ad

Tür

Açıklama

ToAddress

Dize

Alıcı adresi.

LastUpdateTime

Dize

Son güncelleme

UtcLastUpdateTime

Uzun

Adresin son güncellenme zamanı, UNIX zaman damgası biçiminde.

Ad

Tür

Gerekli

Açıklama

Action

Dize

Evet

Zorunlu bir parametredir. Değeri SenderStatisticsDetailByParam olarak ayarlayın.

AccountName

Dize

Hayır

Gönderen adresi. Bu parametreyi belirtmezseniz tüm gönderen adreslerine ait veriler döndürülür. Not: AccountName, TagName ve ToAddress parametrelerinin hepsini boş bırakabilirsiniz. Bu parametrelerden herhangi biri için bir değer belirtirseniz yalnızca bunlardan biri için değer belirtebilirsiniz. Bu parametrelerin ikisini veya daha fazlasını bir arada belirtemezsiniz.

TagName

Dize

Hayır

E-posta etiketi. Bu parametreyi belirtmezseniz tüm etiketlere ait veriler döndürülür.

StartTime

Dize

Hayır

Sorgulanacak zaman aralığının başlangıcı. Zaman aralığı 30 günü aşamaz. Biçim yyyy-AA-gg SS:dd şeklindedir.

EndTime

Dize

Hayır

Sorgulanacak zaman aralığının bitişi. Zaman aralığı 30 günü aşamaz. Biçim yyyy-AA-gg SS:dd şeklindedir.

ToAddress

Dize

Hayır

Alıcı adresi. Bu parametreyi belirtmezseniz tüm alıcı adreslerine ait veriler döndürülür.

Status

Tamsayı

Hayır

Teslim durumu. Bu parametreyi belirtmezseniz tüm durumlara ait veriler döndürülür. Geçerli değerler: 0 (başarılı), 2 (geçersiz adres), 3 (istenmeyen posta) ve 4 (başarısız).

Length

Tamsayı

Hayır

Yanıta dahil edilecek kayıt sayısı. Değer 1 ile 100 arasında olmalıdır.

NextStart

Dize

Hayır

Sayfalama için kullanılır. Geçerli istek için ofseti belirtir. Daha fazla sonuç varsa bu parametreyi bir sonraki istek için yanıttaki NextStart değerine ayarlayın.

Ad

Tür

Açıklama

Data

Dizi

Veriler.

NextStart

Dize

Sayfalama için kullanılır. Daha fazla sonuç varsa bir sonraki istekteki NextStart parametresini bu değere ayarlayın.

Ad

Tür

Açıklama

mailDetail

Liste

Kayıtlar.

Ad

Tür

Açıklama

ToAddress

Dize

Alıcı adresi.

LastUpdateTime

Dize

Kaydın son güncellenme zamanı.

UtcLastUpdateTime

Dize

Kaydın son güncellenme zamanı, UNIX zaman damgası biçiminde.

AccountName

Dize

Gönderen adresi.

Message

Dize

Teslim ayrıntıları.

Status

Tamsayı

Teslim durumu. Geçerli değerler: 0 (başarılı), 2 (geçersiz adres), 3 (istenmeyen posta) ve 4 (diğer hatalar).

Subject

Dize

E-posta konusu.

ErrorClassification

Dize

Hatanın ayrıntılı sınıflandırması. Örnekler:

• SendOk

• SmtpNxBox

vb.