Servisler
Başlarken
PanelKeşfet API
REX API
Ödeme Yönetimi
Listedeki kullanıcılara mesaj gönderimi
Çok kullanıcıya mesaj/mesajlar gönderimini sağlayan servistir. Sendgmsgserv’den farklı olarak servisle kullanıcı arasında geçerli bir session olması gerekmez (servisinizi takip eden kişi uzun süredir servisinizle iletişime geçmediyse bile mesaj atabilirsiniz) ve receivers alanına alıcı listesi verilir. Eş zamansız çalışır.
Format
Servis kullanıcı adı/şifresi Basic Authentication kullanılarak Header içerisinde gönderilir.POSThttps://tims.turkcell.com.tr/tes/rest/spi/sendmsgservlist
| Özellik | Değer | Açıklama |
| *txnid | string | isteğe ait id değeri |
| *receivers | list | |
| *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 | 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 |
| Ö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: Metin gönderimi
{
"txnid": "250-ABC-1234",
"receivers": [{
"type": 2,
"address": "380XXXXXXXXX"
}, {
"type": 2,
"address": "380XXXXXXXXX"
}],
"composition": {
"list": [{
"type": 0,
"message": "Selam Dünya"
}]
}
}
{
"txnid": "250-ABC-1234",
"resultcode": 0,
"report": null
}
Bu servis eş zamansız çalıştığından report alanı null gelmektedir. reportid’ler geri bildirim url’i+/report adresine gönderilir. Bu reportid’lere ait iletildi/okundu rapoları servisin geri bildirim url’inden dinlenir. Detaylı bilgi için rapor alma bölümünü inceleyiniz.
Doğrulamalar
- txnid değeri null, boş ya da 40 karakterden fazla olamaz. [1000]
- receiver listesi null olamaz, boş olamaz, eleman sayısı 500’den fazla olamaz. [1008]
- receiver listesindeki elemanların type değeri aynı olmalıdır. Listenin ilk elemanı şifrelenmiş numaraysa [type:2] diğer elemanları da şifrelenmiş numara olmalıdır. [1009]
- receiver listesinde aynı alıcıdan 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 |
| 1009 | invalid receiver type |
| 1010 | duplicate receiver |
