Listedeki kullanıcılara farklı mesaj gönderimi

Çok kullanıcıya farklı mesaj/mesajlar gönderimini sağlayan servistir. Sendgmsgservlist’den farklı olarak kullanıcılara farklı mesajlar gönderilebilir. receivercontentlist alanına her mesaj için alıcı, gönderilecek mesaj ve isteğe bağlı olarak kaybolma değeri girilir. Eş zamansız çalışır.

Format

Servis kullanıcı adı/şifresi Basic Authentication kullanılarak Header içerisinde gönderilir.

https://tims.turkcell.com.tr/tes/rest/spi/ sendmultiusermulticontent

İstek

Özellik	Değer	Açıklama
*txnid	string	isteğe ait id değeri
*receiver	object
*type	int	Mesaj gönderilecek kullanıcının adres türü. Alabileceği değerler: 0 -> Hash (karıştırılmış) adres 1 -> Servisi takip eden tüm adresler 2 -> MSISDN (açık numara)
*address	string	type ile belirtilen türdeki adres. type 0 ise address karıştırılmış formattadır, bipussu tarafından verilen değer girilir. type 1 ise address değeri istek içerisinde yer almamalıdır. type 2 ise address 905XXXXXXXXX formatında verilir.
*composition	object
*list	list	Gönderilecek mesaj listesi. En az 1 tane eklenmelidir.
*type	int	Mesaj tipi. Alabileceği değerler: 0 – Metin 2 – Fotoğraf 3 – Ses 4 – Video 5 – Çıkartma 6 – Caps 7 – Konum 9 – Bitiş Çizgisi 10 – Kontak 13 – Şablon Medya Mesajı 14 – Doküman seçilen tipe bağlı olarak diğer parametreler eklenir İçerik tipine bağlı olarak farklı parametreler bu alanda yer alır. Formatlar için içerik tipleri listesini inceleyin.
expire	int	Mesajın kaç saniye sonra kaybolcağını belirten değerdir. Alabileceği değerler: 3,5,10,60
ekstra param.		İçerik tipine bağlı olarak farklı parametreler bu alanda yer alır. Formatlar için içerik tipleri listesini inceleyin.

Yanıt

Özellik	Değer	Açıklama
*txnid	string	isteğe ait id değeri
*resultcode	string	Yanıt değeri. Başarılı işlemler için 0 dönülür. Hatalı işlemler için Hata Kodları kısmında belirtilen değer dönülür.

Örnek

İstek

{  
    "txnid": "200",  
    "receivercontentlist": [{  
        "receiver": {  
            "type": 2,  
            "address": "905XXXXXXXXX"
        },  
        "composition": {  
            "list": [{  
                "type": 0,  
                "message": "test"  
            }]  
        }  
    }, {  
        "receiver": {  
            "type": 2,  
            "address": "3805XXXXXXXXX"
        },  
        "composition": {  
            "list": [{  
                "type": 0,  
                "message": "test2"  
            }]  
        }  
    }]  
}

Yanıt

{  
    "txnid": "200",  
    "resultcode": 0,  
    "report": null  
}

Doğrulamalar

txnid değeri null, boş ya da 40 karakterden fazla olamaz. [1000]
receivercontentlist null olamaz, boş olamaz, eleman sayısı 500’den fazla olamaz. [1008]
receivercontentlist’te aynı alıcı birden fazla bulunamaz. [1010]
type değeri null olamaz, boş olamaz. 0, 1, 2 harici bir değer olamaz. [1008]

Address değeri:

type değeri 0 (şifrelenmiş numara) iken null ya da boş olmamalıdır. [1008]
type değeri 2 (şifrelenmemiş numara) iken null ya da boş olmamalıdır. En az 3 en fazla 15 karakter uzunluğunda ve MSISDN (E164 formatı) formatında olmalıdır. [1008]

expire değeri null olabilir. Fakat 3, 5, 10, 60 harici bir değer olamaz. [1001].
composition alanı boş olamaz, içerisindeki list alanı null olamaz, boş olamaz. Listenin eleman sayısı 5’den fazla olamaz. [1002]
listin içerisindeki her eleman için içerik tipi doğrulamaları gerçekleştirilir. Her içeriğin kendine özgü formatı ve doğrulamaları vardır, bunlar kontrol edilmelidir.

Hata Kodları

resultcode	Açıklama
1000	invalid txnid
1001	invalid expire value
1002	invalid content
1008	invalid receiver address
1010	duplicate receiver