- Katılım
- 17 Mayıs 2013
- Mesajlar
- 24
- Reaction score
- 0
Kendi yazilimlariniza başlıklı sms entegrasyonu yapmayı dusunuyorsanız asagida bir kismini yazdigim HTTP XML API nin size yardimi olacaktir. Ornek PHP kodu yer alan sms api dosyasinin tamamini html olarak goruntulemek veya pdf olarak indirmek icin www.toplusmsapi.com sitemizi ziyaret edebilirsiniz. Sorulariniz ve destek icin 0212-543-4210 dan veya www.toplusmsapi.com sayfanin sag alt kosesindeki canli destek bolumunden bizlere ulasabilirsiniz.
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.coma 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.coma 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
D ş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
Örnek Yanıt
Ornek PHP kodu yer alan sms api dosyasinin tamamini html olarak goruntulemek veya pdf olarak indirmek icin www.toplusmsapi.com sitemizi ziyaret edebilirsiniz.
.
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ı:
HTML:
<request>
<authentication>
<username></username>
<password></password>
</authentication>
<order>
<sender></sender>
<sendDateTime></sendDateTime>
<message>
<text><![CDATA[...]]></text>
<receipents>
<number></number>
<number></number>
...
</receipents>
</message>
<message>
...
</message>
...
</order>
</request>
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.coma 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.coma 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
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ı:
HTML:
<response>
<status>
<code></code>
<message></message>
</status>
<order>
<id></id>
</order>
</response>
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
HTML:
<?xml version="1.0" encoding="UTF-8" ?>
<request>
<authentication>
<username>KULLANICI_ADI</username>
<password>KULLANICI_SIFRESI</password>
</authentication>
<order>
<sender>ILETI MRKZI</sender>
<sendDateTime>13/01/2014 09:00</sendDateTime>
<message>
<text><![CDATA[Lorem ipsum dolor sit amet, consectetur adipiscing elit.]]></text>
<receipents>
<number>5301234567</number>
<number>5301234568</number>
</receipents>
</message>
<message>
<text><![CDATA[Nunc non mauris lectus. Vivamus non est enim.]]></text>
<receipents>
<number>5301234569</number>
<number>5301234560</number>
</receipents>
</message>
</order>
</request>
Örnek Yanıt
HTML:
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<message>İşlem başarılı</message>
</status>
<order>
<id>428</id>
</order>
</response>
Ornek PHP kodu yer alan sms api dosyasinin tamamini html olarak goruntulemek veya pdf olarak indirmek icin www.toplusmsapi.com sitemizi ziyaret edebilirsiniz.
.