WORLD SMS API

Bakiye Sorgulama

Bu API sorgu adresini kullanılarak kullanıcının bakiyesi sorgulanabilir.

API Sorgu Adresi:

https://worldsms.com.tr/api

XML Yapısı:

<Bakiye>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
</Bakiye>

Olumlu Dönüş Cevabı:

Dönüş cevabı "Kontür Sayısı | Bakiye" şeklindedir. "|" işaretinden önceki kısım Kontür Sayısını, sonraki kısım Bakiyeyi verir.

Örnek : "SMS Kontür Sayısı|Abone Bakiye" 

100|500.00

Olumsuz Dönüş Cevabı:

Olası hata durumları:

  • Hata 01: Bilgilerinize ulaşılamadı.
  • Hata 02: Api kullanımı kapalıdır.
  • Hata 03: Geçersiz XML yapısı!
  • Hata 04: Eksik veya geçersiz veri!

PHP Kodu Örneği

<?php

$url = "https://worldsms.com.tr/api";

$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$headers = array(
   "Content-Type: application/xml",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$data ="<Bakiye>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
</Bakiye>"

curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);

?>

Başlık Sorgulama

Bu API sorgu adresini kullanılarak kullanıcının aktif SMS başlıkları sorgulanabilir.

API Sorgu Adresi:

https://worldsms.com.tr/api

XML Yapısı:

<Basliklar>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
</Basliklar>

Olumlu Dönüş Cevabı:

Dönüş cevabı başlıklar arasında "|" işareti ile ayrılmış şekildedir.

BASLIK1|BASLIK2|BASLIK3

Olumsuz Dönüş Cevabı:

Olası hata durumları:

  • Hata 01: Bilgilerinize ulaşılamadı.
  • Hata 02: Api kullanımı kapalıdır.
  • Hata 03: Geçersiz XML yapısı!
  • Hata 04: Eksik veya geçersiz veri!

PHP Kodu Örneği

<?php

$url = "https://worldsms.com.tr/api";

$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$headers = array(
   "Content-Type: application/xml",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$data ="<Basliklar>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
    </Basliklar>"

curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);

?>

Çoklu SMS Gönderme

Bu API sorgu adresini kullanılarak birden fazla numaraya SMS gönderilebilir.

API Sorgu Adresi:

https://worldsms.com.tr/api

XML Yapısı:

<SmsGonder>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
    <MesajTuru>CokluSMS</MesajTuru>
    <Dil>Turkce</Dil>
    <Baslik>WORLD SMS</Baslik>
    <Numaralar>50********,54********,53********</Numaralar>
    <Mesaj>World SMS Api Test Mesajıdır</Mesaj>
    <GonderimZamani>25/02/2025 18:15:00</GonderimZamani>
    <ZamanAsimi>28/02/2025 18:15:00</ZamanAsimi>
</SmsGonder>

Olumlu Dönüş Cevabı:

Dönüş cevabı 3 parametre içerir ve parametreler "|" işareti ile ayrılır:

Örnek : "Gönderim sonucu|SMSID|Kişi Sayısı"

  • 1. Parametre: Gönderim sonucu (0: Başarısız, 1: Başarılı)
  • 2. Parametre: Gönderilen SMS'in ID'si
  • 3. Parametre: SMS'in gönderildiği kişi sayısı
1|2548|4

Olumsuz Dönüş Cevabı:

Olası hata durumları:

  • Hata 01: Bilgilerinize ulaşılamadı.
  • Hata 02: Api kullanımı kapalıdır.
  • Hata 03: Geçersiz XML yapısı!
  • Hata 04: Eksik veya geçersiz veri!
  • Hata 05: Bakiyeniz yetersiz.
  • Hata 06: XML yapısı bozuk.
  • Hata 07: Gönderim tarihi hatalı.

PHP Kodu Örneği

<?php

$url = "https://worldsms.com.tr/api";

$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$headers = array(
   "Content-Type: application/xml",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$data ="<SmsGonder>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
    <MesajTuru>CokluSMS</MesajTuru>
    <Dil>Turkce</Dil>
    <Baslik>WORLD SMS</Baslik>
    <Numaralar>50********,54********,53********</Numaralar>
    <Mesaj>World SMS Api Test Mesajıdır</Mesaj>
    <GonderimZamani>25/02/2025 18:15:00</GonderimZamani>
    <ZamanAsimi>28/02/2025 18:15:00</ZamanAsimi>
    </SmsGonder>"

curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);

?>

Hitaplı SMS Gönderme

Bu API sorgu adresini kullanılarak birden fazla numaraya hitap içeren SMS gönderilebilir.

API Sorgu Adresi:

https://worldsms.com.tr/api

XML Yapısı:

<CokluSmsGonder>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
    <MesajTuru>HitapliSMS</MesajTuru>
    <Dil>Turkce</Dil>
    <Baslik>WORLD SMS</Baslik>
    <Mesajlar>
        <Numara>50********</Numara><Mesaj>Merhaba Sayın ... </Mesaj>
        <Numara>54********</Numara><Mesaj>Merhaba Sayın ... </Mesaj>
        <Numara>53********</Numara><Mesaj>Merhaba Sayın ... </Mesaj>
    </Mesajlar>
    <GonderimZamani>25/02/2025 18:15:00</GonderimZamani>
    <ZamanAsimi>28/02/2025 18:15:00</ZamanAsimi>
</CokluSmsGonder>

Olumlu Dönüş Cevabı:

Dönüş cevabı 3 parametre içerir ve parametreler "|" işareti ile ayrılır:

Örnek : "Gönderim sonucu|SMSID|Kişi Sayısı"

  • 1. Parametre: Gönderim sonucu (0: Başarısız, 1: Başarılı)
  • 2. Parametre: Gönderilen SMS'in ID'si
  • 3. Parametre: SMS'in gönderildiği kişi sayısı
1|2548|4

Olumsuz Dönüş Cevabı:

Olası hata durumları:

  • Hata 01: Bilgilerinize ulaşılamadı.
  • Hata 02: Api kullanımı kapalıdır.
  • Hata 03: Geçersiz XML yapısı!
  • Hata 04: Eksik veya geçersiz veri!
  • Hata 05: Bakiyeniz yetersiz.
  • Hata 06: XML yapısı bozuk.
  • Hata 07: Gönderim tarihi hatalı.

PHP Kodu Örneği

<?php

$url = "https://worldsms.com.tr/api";

$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$headers = array(
   "Content-Type: application/xml",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$data ="<SmsGonder>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
    <MesajTuru>CokluSMS</MesajTuru>
    <Dil>Turkce</Dil>
    <Baslik>WORLD SMS</Baslik>
    <Numaralar>50********</Numaralar>
    <Mesaj>World SMS Api Test Mesajıdır</Mesaj>
    <GonderimZamani>25/02/2025 18:15:00</GonderimZamani>
    <ZamanAsimi>28/02/2025 18:15:00</ZamanAsimi>
    </SmsGonder>"

curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);

?>

SMS Rapor Sorgulama

Bu API sorgu adresini kullanılarak belirli bir SMS'in durumu sorgulanabilir.

API Sorgu Adresi:

https://worldsms.com.tr/api

XML Yapısı:

<SmsSorgulama>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
    <SMSID>2548</SMSID>
</SmsSorgulama>

Olumlu Dönüş Cevabı:

Dönüş cevabı, telefon numaraları ve durum kodları arasında "<br>" işareti ile ayrılmış şekildedir. Her bir numara ve durum kodu arasında bir "|" bulunur.

Örnek : "Telefon Numarası|Sonuç|Açıklama|Zaman <br>" 

				50********|0|Gönderiliyor|0000-00-00 00:00:00<br>

				50********|1|İletildi|0000-00-00 00:00:00<br>

				50********|2|İletilemedi|0000-00-00 00:00:00<br>

				50********|3|İletilecek|0000-00-00 00:00:00<br>

Durum kodları:

  • 0: Mesaj Gönderiliyor
  • 1: Mesaj iletildi
  • 2: Mesaj iletilemedi
  • 3: Mesaj iletilecek

Olumsuz Dönüş Cevabı:

Olası hata durumları:

  • Hata 01: Bilgilerinize ulaşılamadı.
  • Hata 02: Api kullanımı kapalıdır.
  • Hata 03: Geçersiz XML yapısı!
  • Hata 04: Eksik veya geçersiz veri!
  • Hata 05: Rapor Bekleniyor.
  • Hata 06: Rapor bulunamadı.

PHP Kodu Örneği

<?php

$url = "https://worldsms.com.tr/api";

$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$headers = array(
   "Content-Type: application/xml",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$data ="<SmsSorgulama>
    <UserName>Api Kullanıcı Adı</UserName>
    <PassWord>Api Şifre</PassWord>
    <UserNo>Api Kodu</UserNo>
    <SMSID>2548</SMSID>
    </SmsSorgulama>"

curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);

?>