Sistemlerine sms api mizi entegre eden gelistiricilere veya firmalara liste fiyatlarimiz uzerinden ektra indirim yapiyoruz.
HTTP XML POST API
SMS Gönderimi
İstek yapılacak adres:
http://api.iletimerkezi.com/v1/send-sms
Yapılacak olan isteğin genel XML yapısı:
...
...
...
Tanımlar:
Sunucuya yapılacak olan istek “request” etiketi ile sarmalanmalıdır. Bu etiketin alt etiketlerinin tanımları aşağıdaki gibidir:
authentication:
İstek yapılan işleme dair yetki alabilmek için gönderilmesi gereken kullanıcı bilgileridir. Alt etiketleri aşağıdaki gibidir:
username:
iletimerkezi.com’a giriş yaparken kullanılan kullanıcı adıdır. Genellikle kayıt aşamasında verilen cep telefonu numarasıdır. İstek yapılırken gönderilmesi zorunludur.
password:
iletimerkezi.com’a giriş yaparken kullanılan şifredir. İstek yapılırken gönderilmesi zorunludur.
order:
Gönderilecek olan SMSler bir sipariş olarak kabul edilir ve istek yapıldıktan sonra bu şekilde raporlanmaya başlanır. Bu sipariş bazı zamanlar tek alıcıya tek mesaj içerebileceği gibi birden fazla alıcıya birden fazlı mesaj da içerebilir. Alt etiketleri aşağıdaki gibidir:
sender:
iletimerkezi.com yönetim panelinden tanımlamış ve iletimerkezi.com tarafından onaylanmış, maksimum 11 karakterden oluşan başlık bilgisidir. Gönderilen mesaj, alıcıya bu parametre ile belirtilen başlık ile yollanır. İstek yapılırken gönderilmesi zorunludur.
sendDateTime:
Mesajın gönderim tarihini ifade eder. İleri tarihli mesaj gönderimleri için kullanılır. Formatı GG/AA/YYYY SS:DD şeklindedir. İstek yapılırken gönderilmesi zorunlu değildir. Varsayılan değeri, istek yapılan zamandır.
message:
Gönderilecek olan mesaj bilgisini içerir. Alt etiketleri aşağıdaki gibidir:
text:
Gönderilecek olan SMS metnini içerir. İstek yapılırken gönderilmesi zorunludur.
receipents:
Gönderilecek olan SMSlerin alıcılarını içerir. Alıcılar aşağıdaki etiket ile belirtilir:
number:
Alıcının cep telefonu numarasını içerir. 905xxxxxxxxx, +90 5xx xxx xx xx, 5xxxxxxxxx gibi formatlar kullanılabilir. İstek yapılırken gönderilmesi zorunludur. Belirtilen mesaj metni için birden fazla alıcı tanımlanacaksa bu etiket alıcı sayısı kadar tekrarlanmalıdır.
Tek sipariş içinde farklı mesaj gönderilmek isteniyorsa “message” etiketi gönderilmek istenen farklı mesaj sayısı kadar tekrarlanmalıdır.
“order” etiketi tekrarlanabilir bir etiket değildir. İstek başına yalnızca bir sipariş gönderilebilir.
Sunucu yanıtının XML yapısı:
Tanımlar:
Sunucudan gelen yanıt her zaman “response” etiketi ile sarmalanmıştır. Bu etiketi alt etiketlerinin tanımı aşağıdaki gibidir:
status:
İşlem durumu ile ilgili bilgi içerir. Bu etiket ile döndürülen değerler aynı zamanda HTTP yanıtının başlık bilgisine bakılarak da elde edilebilir. Bu etiket, yapılan her istekte standart olarak döndürülür. Alt etiketleri aşağıdaki gibidir:
code:
İşlem durumunu belirten numerik değerdir.
message:
İşlem durumu hakkında bilgi mesajı içerir.
order:
İşlem başarılı olarak tamamlandıysa oluşturulan sipariş bilgisini içerir. İşlem başarısızsa bu etiket döndürülmez. Alt etiketi aşağıdaki gibidir:
id:
Siparişi ifade eden eşsiz numerik değerdir.
“order” etiketi tekrarlanabilir bir etiket değildir. İstek başına yalnızca bir sipariş gönderilebilir.
Örnek İstek
KULLANICI_ADI
KULLANICI_SIFRESI
ILETI MRKZI
13/01/2014 09:00
5301234567
5301234568
5301234569
5301234560
Örnek Yanıt
200
İşlem başarılı
428
Ornek PHP kodu yer alan sms api dosyasinin tamamini html olarak goruntulemek veya pdf olarak indirmek icin www.toplusmsapi.com sitemizi ziyaret edebilirsiniz.
.
