Sistemlerine sms api mizi entegre eden gelistiricilere veya firmalara liste fiyatlarimiz uzerinden ektra indirim yapiyoruz.
HTTP XML POST API
SMS Gonderimi
İstek yapılacak adres:
http://api.iletimerkezi.com/v1/send-sms
Yapılacak olan isteğin genel XML yapısı:
HTML:
... ... ...
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 icin gonderilmesi 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 gonderilmesi zorunludur.
password:
iletimerkezi.com’a giriş yaparken kullanılan şifredir. İstek yapılırken gonderilmesi zorunludur.
order:
Gonderilecek 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 icerebileceği gibi birden fazla alıcıya birden fazlı mesaj da icerebilir. Alt etiketleri aşağıdaki gibidir:
sender:
iletimerkezi.com yonetim panelinden tanımlamış ve iletimerkezi.com tarafından onaylanmış, maksimum 11 karakterden oluşan başlık bilgisidir. Gonderilen mesaj, alıcıya bu parametre ile belirtilen başlık ile yollanır. İstek yapılırken gonderilmesi zorunludur.
sendDateTime:
Mesajın gonderim tarihini ifade eder. İleri tarihli mesaj gonderimleri icin kullanılır. Formatı GG/AA/YYYY SS
message:
Gonderilecek olan mesaj bilgisini icerir. Alt etiketleri aşağıdaki gibidir:
text:
Gonderilecek olan SMS metnini icerir. İstek yapılırken gonderilmesi zorunludur.
receipents:
Gonderilecek olan SMSlerin alıcılarını icerir. Alıcılar aşağıdaki etiket ile belirtilir:
number:
Alıcının cep telefonu numarasını icerir. 905xxxxxxxxx, +90 5xx xxx xx xx, 5xxxxxxxxx gibi formatlar kullanılabilir. İstek yapılırken gonderilmesi zorunludur. Belirtilen mesaj metni icin birden fazla alıcı tanımlanacaksa bu etiket alıcı sayısı kadar tekrarlanmalıdır.
Tek sipariş icinde farklı mesaj gonderilmek isteniyorsa “message” etiketi gonderilmek istenen farklı mesaj sayısı kadar tekrarlanmalıdır.
“order” etiketi tekrarlanabilir bir etiket değildir. İstek başına yalnızca bir sipariş gonderilebilir.
Sunucu yanıtının XML yapısı:
HTML:
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 icerir. Bu etiket ile dondurulen 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 dondurulur. Alt etiketleri aşağıdaki gibidir:
code:
İşlem durumunu belirten numerik değerdir.
message:
İşlem durumu hakkında bilgi mesajı icerir.
order:
İşlem başarılı olarak tamamlandıysa oluşturulan sipariş bilgisini icerir. İşlem başarısızsa bu etiket dondurulmez. 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ş gonderilebilir.
Ornek İstek
HTML:
KULLANICI_ADI
KULLANICI_SIFRESI ILETI MRKZI 13/01/2014 09:00 5301234567 5301234568 5301234569 5301234560
Ornek Yanıt
HTML:
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.
.