SMS API Dokümantasyonu

Bu sayfa SMS gönderimi, SMS raporu ve bakiye sorgulama işlemlerini tek yerde, örnek istek/cevaplarla anlatır.

API URL

https://www.oaksms.com/

Kullanıcı Adı

ID937

Şifre

123456

1) SMS Gönderimi

Endpoint: https://www.oaksms.com/sms/

Örnek XML İstek

<?xml version="1.0" encoding="ISO-8859-9"?>
<SMS>
  <KULLANICIADI>ID937</KULLANICIADI>
  <SIFRE>123456</SIFRE>
  <BASLIK></BASLIK>
  <TARIH></TARIH>
  <MESAJLAR>
    <LISTE>
      <NUMARA>5539234423</NUMARA>
      <MESAJ>Test SMS - API baglantisi basarili.</MESAJ>
    </LISTE>
  </MESAJLAR>
</SMS>

Örnek Başarılı Cevap

{
  "success": true,
  "http_code": 200,
  "endpoint": "https://www.oaksms.com/sms/",
  "number": "5539234423",
  "response": {
    "KOD": "1",
    "ISLEMNO": "748043",
    "KREDI": "748043"
  }
}
  • KOD=1: Gönderim kabul edildi.
  • ISLEMNO: Rapor sorgusunda kullanılacak işlem numarası.

2) SMS Raporu Sorgulama

Endpoint: https://www.oaksms.com/sms/?kullaniciadi=ID937&sifre=123456&islemno=748043

Örnek Cevap

{
  "success": true,
  "http_code": 200,
  "islemno": "748043",
  "response": {
    "SONUC": {
      "NUMARA": "5539234423",
      "KOD": "2"
    }
  }
}

Rapor KOD Anlamları

1 = İletildi

2 = Bekliyor

3 = İptal

Not:

KOD=2 ise mesaj henüz sonuca ulaşmamıştır. Birkaç dakika sonra aynı islemno ile tekrar sorgulayın.

3) Bakiye Sorgulama

Endpoint: https://www.oaksms.com/sms/?kullaniciadi=ID937&sifre=123456&kredi=1

Örnek XML Cevap

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

JSON Çıktı Örneği

{
  "success": true,
  "http_code": 200,
  "response": {
    "KREDI": "748043"
  },
  "balance": "748043"
}

Hızlı Akış

  1. SMS gönder ve ISLEMNO al.
  2. ISLEMNO ile rapor sorgula.
  3. Rapor KOD=2 ise bekleyip tekrar sorgula.
  4. Gerekirse bakiye endpointi ile kredi kontrolü yap.