SMS API, SMPP API MS Zamanlayıcı API'si
Kullanıcı Kılavuzu
SMS API, SMPP API MS Zamanlayıcı API'si
| Değiştirildi: | 6/24/2025 |
| Sürüm: | 1.7 |
| Yazar: | Kenny Colander Norden, KCN |
Bu belge yalnızca belirlenen alıcı içindir ve ayrıcalıklı, özel veya başka şekilde özel bilgiler içerebilir. Eğer yanlışlıkla aldıysanız, lütfen göndericiyi derhal bilgilendirin ve orijinali silin. Belgenin tarafınızca başka herhangi bir şekilde kullanılması yasaktır.
Değişiklik geçmişi
| Rahip | Tarih | By | Önceki sürümden değişiklikler |
| 1.0 | 2010-03-16 | KCN | Oluşturuldu |
| 1. | 2019-06-11 | TPE | LINK logoları güncellendi |
| 1. | 2019-09-27 | PNI | SMPP 3.4 spesifikasyonuna referans eklendi |
| 1. | 2019-10-31 | EP | Geçerlilik süresi ile ilgili gözlem tag |
| 1. | 2020-08-28 | KCN | Desteklenen TLS sürümleriyle ilgili bilgiler eklendi |
| 2. | 2022-01-10 | KCN | Added additional information regarding delivery reports Updated information regarding TLS 1.3 |
| 2. | 2025-06-03 | GM | Added result code 2108 |
| 2. | 2025-06-24 | AK | Added quota |
giriiş
LINK Mobility, 2001'den beri bir SMS distribütörü olmuştur ve hem operatörlerle hem de bağlantı toplayıcılarla çalışma konusunda büyük deneyime sahiptir. Bu platform, büyük trafik hacimlerini işlemek, yüksek kullanılabilirliği sürdürmek ve birden çok bağlantı aracılığıyla trafiği yönlendirmeyi kolaylaştırmak için tasarlanmıştır.
Bu belge, SMSC platformuna SMPP arayüzünü ve hangi parametrelerin ve komutların gerekli olduğunu ve hangi parametrelerin desteklendiğini açıklamaktadır.
This document will not handle specific use cases as concatenated messages, WAPpush, Flash SMS, etc. More information about those cases can be provided by contacting support.
Desteklenen komutlar
LINK Mobility'nin sunucusu SMPP 3.4 olarak ele alınmalıdır. Resmi şartname şu adreste bulunabilir: https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Tüm yöntemler desteklenmez ve tüm farklılıklar aşağıda belirtilmiştir.
4.1 Bağlama
Aşağıdaki bağlama komutları desteklenir.
- Verici
- alıcı-verici
- Alıcı
Gerekli parametreler:
- system_id – destekten alınır
- şifre – destekten alınır
İsteğe bağlı parametreler:
- addr_ton – gönderme sırasında TON Bilinmeyen olarak ayarlanırsa varsayılan değer.
- addr_npi – gönderme sırasında NPI Bilinmeyen olarak ayarlanırsa varsayılan değer.
Desteklenmeyen parametreler:
- adres_aralığı
4.2 Bağlantıyı Kaldır
Çöz komutu desteklenir.
4.3 Sorgu bağlantısı
Inquire link komutu desteklenir ve her 60 saniyede bir çağrılmalıdır.
4.4 Gönder
İletileri iletmek için gönderme yöntemi kullanılmalıdır.
Gerekli parametreler:
- kaynak_addr_ton
- kaynak_addr_npi
- kaynak_adresi
- hedef_adres_ton
- hedef_adres_npi
- hedef_addr
- esm_sınıfı
- Veri kodlama
- sm_uzunluğu
- kısa mesaj
Desteklenmeyen parametreler:
- servis tipi
- protokol_kimliği
- öncelik_işareti
- program_delivery_time
- replacement_if_current_flag
- sm_varsayılan_mesaj_kimliği
Not o yük tag desteklenmez ve arama başına yalnızca bir SMS gönderilebilir ve tag en az 15 dakika uzunluğunda bir değere sahiptir.
4.4.1 Önerilen TON ve NPI
Gönder komutunu kullanarak mesaj gönderirken aşağıdaki TON ve NPI kullanılmalıdır.
4.4.1.1 Kaynak
The following TON and NPI combinations are supported for source address. All other combinations will be treated as invalid. The default TON from bind command will be used if TON is set to Unknown (0). The default NPI from bind command will be used if NPI is set to Unknown (0).
| TON | NPI | Tanım |
| alfasayısal (5) | Bilinmeyen (0) ISDN (1) |
Alfasayısal gönderen metni olarak ele alınacaktır |
| Uluslararası (1) | Bilinmeyen (0) ISDN (1) |
MSISDN olarak ele alınacak |
| Ulusal (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
Bilinmeyen (0) ISDN (1) Ulusal (8) |
Ülkeye özgü kısa numara olarak ele alınacaktır. |
4.4.1.2 Hedef
Hedef adres için aşağıdaki TON ve NPI kombinasyonları desteklenir. Diğer tüm kombinasyonlar geçersiz olarak değerlendirilecektir. TON, Bilinmeyen (0) olarak ayarlanırsa, bağlama komutundan varsayılan TON kullanılacaktır. NPI Bilinmeyen (0) olarak ayarlanırsa, bağlama komutundan alınan varsayılan NPI kullanılacaktır.
| TON | NPI | Tanım |
| Uluslararası (1) | Bilinmeyen (0) ISDN (1) |
MSISDN olarak ele alınacak |
4.4.2 Desteklenen kodlamalar
Aşağıdaki kodlamalar desteklenir. X herhangi bir değer içerebilir.
| DÇS | Kodlama |
| 0xX0 | Uzantıya sahip varsayılan GSM Alfabesi |
| 0xX2 | 8 bitlik ikili |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kota
5.1 Kota Aşımıview
A quota defines the maximum number of SMS messages that can be sent within a specified time interval (such as per day, week, month, or indefinitely). Each quota is uniquely identified by a quotaId (UUID) and is reset according to the customer’s time zone. Quotas can be assigned at the country, region, or default level through a Quota Profile. Quota can also be dynamically assigned using Quota Mapping. This maps a parent QuotaId (UUID) and a unique quota Key (e.g., sender or user) to a specific quotaId.
Kota, yerel desteğinize, size atanmış hesap yöneticinize göre veya hiçbir şey belirtilmemişse varsayılan olarak ayarlanır.
5.2 Status 106 – Quota Exceeded
An SMS message may be blocked with status code 106 (“quota exceeded”) when:
- The message exceeds the defined limit for its corresponding quotaId within the current interval.
- The destination country or region has no quota assigned (i.e., is explicitly blocked with a null quota mapping in the profile).
- There is no matching quota and no default quota is defined, resulting in rejection.
Bu durumlarda sistem, müşteri veya hedef bazlı sınırlamaları uygulamak ve kötüye kullanımı önlemek için daha fazla mesaj işlenmesini engeller.
Teslimat raporu
Yalnızca hiçbiri veya başarılı/başarısız sonucu olan nihai teslimat desteklenir.
Teslim raporunda format: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx bitiş tarihi: yyMMddHHmm stat:
Durumda mevcut değerler:
- TESLİM
- GÜNÜ GEÇMİŞ
- REDDEDİLDİ
- TESLİM EDİLMEMİŞ
- SİLİNDİ
6.1 Genişletilmiş teslimat raporu formatı
Sevkiyat raporlarındaki genişletilmiş bilgiler, satış temsilciniz ile görüşerek talep edilebilir.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Durumda mevcut değerler:
- TESLİM
- GÜNÜ GEÇMİŞ
- REDDEDİLDİ
- TESLİM EDİLMEMİŞ
- SİLİNDİ
“sub” ve “dlvrd” alanları her zaman 000 olarak ayarlanacak ve “text” alanı her zaman boş olacaktır.
"Err" alanı değerleri için Hata kodları bölümüne bakın.
Desteklenen TLS sürümleri
SMPP üzerinden tüm TLS bağlantıları için TLS 1.2 veya TLS 1.3 gereklidir.
TLS 1.0 ve 1.1 desteği, 2020-11-15'ten itibaren durdurulmuştur. TLS'nin 1.0 ve 1.1 sürümleri, kullanımdan kaldırılmış ve İnternet topluluğunda güvenlik riskleri olarak kabul edilen eski protokollerdir.
LINK, günümüzde şifrelenmemiş SMPP bağlantıları kullanılıyorsa TLS'nin kullanılmasını şiddetle tavsiye eder. Şifrelenmemiş SMPP bağlantıları, 2020-09-01 itibarıyla LINK tarafından kullanımdan kaldırılmıştır ve gelecekte kaldırılacaktır. Şifrelenmemiş bağlantıların kaldırılması için tarih henüz kararlaştırılmadı.
TLS için SMPP sunucusuna yönelik bağlantılar, 3601 numaralı bağlantı noktasında şifrelenmemiş yerine 3600 numaralı bağlantı noktasındadır.
SMPP uygulamanız stunnel kullanan TLS'yi desteklemese bile TLS'yi kullanmaya devam edebilirsiniz, bkz. https://www.stunnel.org/
Hata kodları
Hata alanı aktif ise aşağıdaki hata kodları cevaplanabilir.
| Hata kodu | Tanım |
| 0 | Bilinmeyen hata |
| 1 | Geçici yönlendirme hatası |
| 2 | Kalıcı yönlendirme hatası |
| 3 | Maksimum kısma aşıldı |
| 4 | Zaman aşımı |
| 5 | Operatör bilinmeyen hatası |
| 6 | Operatör hatası |
| 100 | Servis bulunamadı |
| 101 | Kullanıcı bulunamadı |
| 102 | Hesap bulunamadı |
| 103 | Geçersiz şifre |
| 104 | Yapılandırma hatası |
| 105 | Dahili hata |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Gönderilmiş |
| 1001 | Teslim edilmiş |
| 1002 | Günü geçmiş |
| 1003 | Silindi |
| 1004 | Mobil dolu |
| 1005 | Sırada bekleyen |
| 1006 | Teslim edilmedi |
| 1007 | Teslim edildi, şarj gecikti |
| 1008 | Ücret alındı, mesaj gönderilmedi |
| 1009 | Ücret alındı, mesaj teslim edilmedi |
| 1010 | Süresi dolmuş, operatör teslimat raporu yok |
| 1011 | Ücret alındı, mesaj gönderildi (operatöre) |
| 1012 | uzaktan kuyruğa alınmış |
| 1013 | Mesaj operatöre gönderildi, şarj gecikmeli |
| 2000 | Geçersiz kaynak numarası |
| 2001 | Kısa numara kaynak olarak desteklenmiyor |
| 2002 | Alfa, kaynak olarak desteklenmiyor |
| 2003 | MSISDN, kaynak numarası olarak desteklenmiyor |
| 2100 | Kısa numara hedef olarak desteklenmiyor |
| 2101 | Alfa, hedef olarak desteklenmiyor |
| 2102 | MSISDN, hedef olarak desteklenmiyor |
| 2103 | İşlem engellendi |
| 2104 | Bilinmeyen abone |
| 2105 | Hedef engellendi |
| 2106 | Sayı hatası |
| 2107 | Hedef geçici olarak engellendi |
| 2108 | Invalid destination |
| 2200 | Şarj hatası |
| 2201 | Abonenin bakiyesi düşük |
|
2202 |
Subscriber barred for overcharged (premium)
mesajlar |
|
2203 |
Subscriber too young (for this particular
içerik) |
| 2204 | Ön ödemeli aboneye izin verilmez |
| 2205 | Abone tarafından reddedilen hizmet |
| 2206 | Abone ödeme sisteminde kayıtlı değil |
| 2207 | Abone maksimum bakiyeye ulaştı |
| 2208 | Son kullanıcı onayı gerekli |
| 2300 | İade edildi |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | Eksik messageId nedeniyle geri ödeme yapılamadı |
| 2303 | Geri ödeme için sıraya alındı |
| 2304 | Geri ödeme zaman aşımı |
| 2305 | Geri ödeme hatası |
| 3000 | GSM kodlaması desteklenmiyor |
| 3001 | UCS2 kodlaması desteklenmiyor |
| 3002 | İkili kodlama desteklenmiyor |
| 4000 | İletim raporu desteklenmiyor |
| 4001 | Geçersiz mesaj içeriği |
| 4002 | geçersiz tarife |
| 4003 | geçersiz kullanıcı verileri |
| 4004 | Geçersiz kullanıcı veri başlığı |
| 4005 | Geçersiz veri kodlaması |
| 4006 | geçersiz KDV |
| 4007 | Hedef için desteklenmeyen içerik |
Belgeler / Kaynaklar
 |
bağlantı hareketliliği SMS API'si,SMPP API'si MS Zamanlayıcı API'si [pdf] Kullanıcı Kılavuzu SMS API SMPP API MS Zamanlayıcı API'si, SMS API SMPP API'si, MS Zamanlayıcı API'si, Zamanlayıcı API'si, API |