SMS API Dokumani

1) Mesaj Gonderme
Endpoint: www.siteadresi.com/sms/

Istek XML:
<?xml version="1.0" encoding="ISO-8859-9"?>
<SMS>
  <KULLANICIADI>....</KULLANICIADI>
  <SIFRE>....</SIFRE>
  <BASLIK>TEST</BASLIK>
  <TARIH></TARIH>
  <MESAJLAR>
    <LISTE>
      <NUMARA>5xxxxxxxxx</NUMARA>
      <MESAJ>TEST MESAJI</MESAJ>
    </LISTE>
  </MESAJLAR>
</SMS>

Notlar:
- TARIH bos ise mesaj hemen gider.
- Ileri tarih formati: 12.12.2015 12:12:12
- NUMARA 5 ile baslamalidir.

2) Gonderim Donusu
<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>
  <KOD>1</KOD>
  <ACIKLAMA>....</ACIKLAMA>
  <ISLEMNO>0</ISLEMNO>
</SONUC>

KOD:
- 1 = Islem basarili
- 2 = Islem basarisiz

ACIKLAMA:
- Basarisiz islem nedeni (or: yetersiz kredi, hatali kullanici bilgisi).

ISLEMNO:
- Basarili gonderimde verilen takip numarasi.

3) SMS Raporu
Endpoint:
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&islemno=1000

Rapor XML:
<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUCLAR>
  <SONUC>
    <NUMARA>5xxxxxxxxx</NUMARA>
    <KOD>1</KOD>
  </SONUC>
  <SONUC>
    <NUMARA>5xxxxxxxxx</NUMARA>
    <KOD>2</KOD>
  </SONUC>
</SONUCLAR>

Rapor KOD:
- 1 = Iletildi
- 2 = Bekliyor
- 3 = Iptal

4) Onayli Basliklar
Endpoint:
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&basliklar=1

Cevap XML:
<?xml version="1.0" encoding="ISO-8859-9"?>
<BASLIKLAR>
  <BASLIK>DENEME</BASLIK>
  <BASLIK>DENEME 2</BASLIK>
</BASLIKLAR>

5) Kalan Kredi
Endpoint:
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&kredi=1

Cevap XML:
<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>
  <KREDI>0.00</KREDI>
</SONUC>
SMS API Dokumantasyonu

1) Mesaj Gonderme
Endpoint:
www.siteadresi.com/sms/

Ornek XML Istegi:
<?xml version="1.0" encoding="ISO-8859-9"?>
<SMS>
  <KULLANICIADI>....</KULLANICIADI>
  <SIFRE>....</SIFRE>
  <BASLIK>TEST</BASLIK>
  <TARIH></TARIH>
  <MESAJLAR>
    <LISTE>
      <NUMARA>5xxxxxxxxx</NUMARA>
      <MESAJ>TEST MESAJI</MESAJ>
    </LISTE>
  </MESAJLAR>
</SMS>

Alan Aciklamalari:
<KULLANICIADI>: Sistem kullanici adiniz.
<SIFRE>: Sistem sifreniz.
<BASLIK>: Mesaj basligi.
<TARIH>: Bos birakilirsa mesaj hemen iletilir. Ileri tarihli gonderim icin format: 12.12.2015 12:12:12
<NUMARA>: 5 ile baslayan telefon numarasi.
<MESAJ>: Mesaj icerigi.

2) Gonderim Donusu ve Kodlar
Ornek XML Cevabi:
<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>
  <KOD>1</KOD>
  <ACIKLAMA>....</ACIKLAMA>
  <ISLEMNO>0</ISLEMNO>
</SONUC>

Alan Aciklamalari:
<KOD>: Sonuc kodu.
  1 = Islem basarili
  2 = Islem basarisiz
<ACIKLAMA>: Islem basarisizsa hata nedeni (ornek: yetersiz kredi, hatali kullanici bilgisi).
<ISLEMNO>: Basarili gonderimde verilen islem numarasi.

3) SMS Raporlari
Endpoint:
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&islemno=1000

Parametreler:
kullaniciadi: Sistem kullanici adiniz.
sifre: Sistem sifreniz.
islemno: Mesaj gonderiminden sonra donen islem numarasi.

Ornek XML Cevabi:
<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUCLAR>
  <SONUC>
    <NUMARA>5xxxxxxxxx</NUMARA>
    <KOD>1</KOD>
  </SONUC>
  <SONUC>
    <NUMARA>5xxxxxxxxx</NUMARA>
    <KOD>2</KOD>
  </SONUC>
</SONUCLAR>

Rapor KOD Degerleri:
1 = Iletildi
2 = Bekliyor
3 = Iptal

4) Onayli Basliklar
Endpoint:
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&basliklar=1

Parametreler:
kullaniciadi: Sistem kullanici adiniz.
sifre: Sistem sifreniz.

Ornek XML Cevabi:
<?xml version="1.0" encoding="ISO-8859-9"?>
<BASLIKLAR>
  <BASLIK>DENEME</BASLIK>
  <BASLIK>DENEME 2</BASLIK>
</BASLIKLAR>

5) Kalan Kredi
Endpoint:
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&kredi=1

Parametreler:
kullaniciadi: Sistem kullanici adiniz.
sifre: Sistem sifreniz.

Ornek XML Cevabi:
<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>
  <KREDI>0.00</KREDI>
</SONUC>
Mesaj Gonderme
XML yolu: www.siteadresi.com/sms/

<?xml version="1.0" encoding="ISO-8859-9"?>
<SMS>
  <KULLANICIADI>....</KULLANICIADI>
  <SIFRE>....</SIFRE>
  <BASLIK>TEST</BASLIK>
  <TARIH></TARIH>
  <MESAJLAR>
    <LISTE>
      <NUMARA>5xxxxxxxxx</NUMARA>
      <MESAJ>TEST MESAJI</MESAJ>
    </LISTE>
  </MESAJLAR>
</SMS>

<BASLIK>: Mesaj basligini ifade eder.
<TARIH>: Bos birakildiginda mesaj hemen iletilir. Ileri tarihli gonderim icin format 12.12.2015 12:12:12 olmalidir.
<NUMARA>: Numara 5 ile baslayacak sekilde yazilmalidir.
<MESAJ>: Mesajin icerigi yazilir.

Donus Kodlari
API ile istek gonderildiginde donus asagidaki gibidir.

<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>
  <KOD>1</KOD>
  <ACIKLAMA>....</ACIKLAMA>
  <ISLEMNO>0</ISLEMNO>
</SONUC>

<KOD>: Donus kodunu ifade eder.
1 = Islem basarili
2 = Islem basarisiz
<ACIKLAMA>: Islem basarisizsa sebebini belirtir. Ornek: Yetersiz kredi, kullanici bilgilerinin hatali olmasi vb.
<ISLEMNO>: Islem basariliysa takip amaciyla verilen islem numarasidir.

SMS Raporlari
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&islemno=1000
<KULLANICIADI>: Sistemdeki kullanici adinizi ifade eder.
<SIFRE>: Sistemdeki sifrenizi ifade eder.
<ISLEMNO>: SMS gonderiminden sonra aldiginiz donusteki islem numarasi gonderilmelidir.

<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUCLAR>
  <SONUC>
    <NUMARA>5xxxxxxxxx</NUMARA>
    <KOD>1</KOD>
  </SONUC>
  <SONUC>
    <NUMARA>5xxxxxxxxx</NUMARA>
    <KOD>2</KOD>
  </SONUC>
</SONUCLAR>

<KOD>: Rapor durum kodunu ifade eder.
1 = Iletildi
2 = Bekliyor
3 = Iptal

Onayli Basliklar
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&basliklar=1
<KULLANICIADI>: Sistemdeki kullanici adinizi ifade eder.
<SIFRE>: Sistemdeki sifrenizi ifade eder.

<?xml version="1.0" encoding="ISO-8859-9"?>
<BASLIKLAR>
  <BASLIK>DENEME</BASLIK>
  <BASLIK>DENEME 2</BASLIK>
</BASLIKLAR>

Kalan Kredi
www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&kredi=1
<KULLANICIADI>: Sistemdeki kullanici adinizi ifade eder.
<SIFRE>: Sistemdeki sifrenizi ifade eder.

<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>
  <KREDI>0.00</KREDI>
</SONUC>
Mesaj Gönderme

XML yolu: www.siteadresi.com/sms/

<?xml version="1.0" encoding="ISO-8859-9"?>
<SMS>
  <KULLANICIADI>....</KULLANICIADI>
  <SIFRE>....</SIFRE>
  <BASLIK>TEST</BASLIK>
  <TARIH></TARIH>
  <MESAJLAR>
    <LISTE>
      <NUMARA>5xxxxxxxxx</NUMARA>
      <MESAJ>TEST MESAJI</MESAJ>
    </LISTE>
  </MESAJLAR>
</SMS>

<BASLIK>: Mesaj başlığını ifade eder.

<TARIH>: Boş bırakıldığında mesaj hemen iletilir. İleri tarihli gönderim için format
12.12.2015 12:12:12 olmalıdır.

<NUMARA>: Numara 5 ile başlayacak şekilde yazılmalıdır.

<MESAJ>: Mesajın içeriği yazılır.


Dönüş Kodları

API ile istek gönderildiğinde dönüş aşağıdaki gibidir.

<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>
  <KOD>1</KOD>
  <ACIKLAMA>....</ACIKLAMA>
  <ISLEMNO>0</ISLEMNO>
</SONUC>

<KOD>: Dönüş kodunu ifade eder.
1 = İşlem başarılı
2 = İşlem başarısız

<ACIKLAMA>: İşlem başarısızsa sebebini belirtir.
Örnek: Yetersiz kredi, kullanıcı bilgilerinin hatalı olması vb.

<ISLEMNO>: İşlem başarılıysa takip amacıyla verilen işlem numarasıdır.


SMS Raporları

www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&islemno=1000

<KULLANICIADI>: Sistemdeki kullanıcı adınızı ifade eder.

<SIFRE>: Sistemdeki şifrenizi ifade eder.

<ISLEMNO>: SMS gönderiminden sonra aldığınız dönüşteki işlem numarası gönderilmelidir.

<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUCLAR>
  <SONUC>
    <NUMARA>5xxxxxxxxx</NUMARA>
    <KOD>1</KOD>
  </SONUC>
  <SONUC>
    <NUMARA>5xxxxxxxxx</NUMARA>
    <KOD>2</KOD>
  </SONUC>
</SONUCLAR>

<KOD>: Rapor durum kodunu ifade eder.
1 = İletildi
2 = Bekliyor
3 = İptal


Onaylı Başlıklar

www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&basliklar=1

<KULLANICIADI>: Sistemdeki kullanıcı adınızı ifade eder.

<SIFRE>: Sistemdeki şifrenizi ifade eder.

<?xml version="1.0" encoding="ISO-8859-9"?>
<BASLIKLAR>
  <BASLIK>DENEME</BASLIK>
  <BASLIK>DENEME 2</BASLIK>
</BASLIKLAR>


Kalan Kredi

www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&kredi=1

<KULLANICIADI>: Sistemdeki kullanıcı adınızı ifade eder.

<SIFRE>: Sistemdeki şifrenizi ifade eder.

<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>
  <KREDI>0.00</KREDI>
</SONUC>
 
Mesaj Yolla

XML yolu: www. siteadresi.com/sms/

<?xml version="1.0" encoding="ISO-8859-9"?>

<SMS>

<KULLANICIADI>....</KULLANICIADI>

<SIFRE>....</SIFRE>

<BASLIK>TEST</BASLIK>

<TARIH></TARIH>

<MESAJLAR>

                <LISTE>

                                <NUMARA>5xxxxxxxxx</NUMARA>

                                <MESAJ>TEST MESAJI</MESAJ>

                </LISTE>

</MESAJLAR>

</SMS>

 

<BASLIK> : Mesajın başlığını ifade eder.

<TARIH> : Boş bırakıldığında mesaj hemen iletilir. Eğer ileri tarihli bir bildirim olacaksa
“12.12.2015 12:12:12” formatında olmalıdır.

<NUMARA> : 5 ile başlayacak şekilde numara yazılmalı.

<MESAJ> : Mesajın içeriği yazılmalı.

 

 

 

 

 

 

 

Dönüş Kodları

API ile istek yollanıldığında dönüşler aşağıdaki gibidir.   


<?xml version="1.0" encoding="ISO-8859-9"?>
<SONUC>

<KOD>1</KOD>

<ACIKLAMA>....</ACIKLAMA>

<ISLEMNO>0</ISLEMNO>

</SONUC>

<KOD> : Kod dönüş kodunu ifade eder.

                1 = İşlem başarılı

                2 = İşlem başarısız

<ACIKLAMA> : İşlem başarısız ise sebebi.

                Örneğin: Yetersiz kredi, Kullanıcı bilgileri hatalı gibi.

<ISLEMNO> : İşlem başarılı ise takip amaçlı işlem no vermektedir.

 

 

 

 

 

 

 

 

 

 

 

 

 

SMS Raporları

www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&islemno=1000                                   


<KULLANICIADI> : Sistemdeki kullanıcı adınızı ifade eder.

<SIFRE> : Sistemdeki şifrenizi  ifade eder.

<ISLEMNO> : Sms’i yolladığınızda aldığınız dönüş kodundaki işlem noyu yollamalısınız.


<?xml version="1.0" encoding="ISO-8859-9"?>

<SONUCLAR>

                <SONUC>

<NUMARA>5xxxxxxxxx</NUMARA>

<KOD>1</KOD>

</SONUC>

<SONUC>

<NUMARA>5xxxxxxxxx</NUMARA>

<KOD>2</KOD>

</SONUC>

</SONUCLAR>

 

<KOD> : Kod dönüş kodunu ifade eder.

                1 = İletildi

                2 = Bekliyor

3 = İptal

 

 

 

 

 

Onaylı Başlıklar

www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&basliklar=1                                         


<KULLANICIADI> : Sistemdeki kullanıcı adınızı ifade eder.

<SIFRE> : Sistemdeki şifrenizi  ifade eder.


<?xml version="1.0" encoding="ISO-8859-9"?>

<BASLIKLAR>

                <BASLIK>DEMEME</BASLIK>

                <BASLIK>DEMEME 2</BASLIK>

</BASLIKLAR>

 

 

Kalan Kredi

www.siteadresi.com/sms/?kullaniciadi=...&sifre=....&kredi=1                                


<KULLANICIADI> : Sistemdeki kullanıcı adınızı ifade eder.

<SIFRE> : Sistemdeki şifrenizi  ifade eder.


<?xml version="1.0" encoding="ISO-8859-9"?>

<SONUC>

                <KREDI>0.00</KREDI>

</SONUC>

 

 

 

 