MODÜL HAKKINDA

Başlık Talebinde Bulunma; HTTP POST methodu kullanılarak işlem yapılabilir. Parametre açıklamaları ve gönderim şekli aşağıda açıklanmıştır.

API KODLARI

<?php
$postUrl = 'http://websms.telsam.com.tr/xmlapi/sendsms';
$username = 'demo';   //Panel girişi yaptığınız Kullanıcı Adınız
$password = 'demo';    //Panel girişi yaptığınız Şifreniz
$originator = 'BASLIK'; //Buraya Başlık gireceksiniz
$text = 'Test Mesaj';

$receivers = array('5320000000', '5420000000');

foreach ( $receivers AS $receiver ){  
    $receiversStr .= '<receiver>' . $receiver . '</receiver>';
}

$xmlStr = '
<?xml version="1.0"?>
<SMS>
  <authentication> 
    <username>' . $username . '</username> 
    <password>' . $password . '</password> 
  </authentication> 
  <message>
    <originator>' . $originator . '</originator> 
    <text>' . $text . '</text> 
    <unicode></unicode> 
  </message>
  <receivers>' . $receiversStr . '</receivers> 
</SMS>';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $postUrl); 
curl_setopt($ch, CURLOPT_POST, 1); 
curl_setopt($ch, CURLOPT_POSTFIELDS, $xmlStr);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$response = curl_exec($ch);

echo $response;
php?>

TANIMLAR

username: Kullanıcı adı

password: Şifre

originator: Eklemek istediğiniz SMS Başlığı

ÖRNEK KOD

POST http://websms.telsam.com.tr/xmlapi/addoriginator

Host: websms.telsam.com.tr

Content-Type: application/xml

Accept: */*

<?xml version="1.0"?>
<INFO>
  <authentication> 
    <username>username</username> 
    <password>password</password> 
  </authentication> 
  <contacts>
     <group_name>GRUP 1</group_name>
     <contact>
        <fullname>Ali Veli</fullname>
        <gsmno>5320000000</gsmno>
        <pstnno>3120000000</pstnno>
        <email>test1@test.com</email>
        <blood>Özel bilgi 1</blood>
     </contact>
     <contact>
        <fullname>Mustafa Veli</fullname>
        <gsmno>5330000000</gsmno>
        <pstnno>2120000000</pstnno>
        <email>test2@test.com</email>
        <blood>Özel bilgi 2</blood>
     </contact>
  </contacts>
</INFO>

BAŞARILI YANIT

API yanıtı XML formatında döner. Aşağıdaki gibi başarılı bir prosedür döndürülen XML yanıttır.

<?xml version="1.0" encoding="UTF-8"?>
<result>
  <status>OK</status>
</result>

HATALAR

API yanıtı XML formatında döner. Aşağıdaki gibi hatalı bir prosedür döndürülen XML yanıttır.

<result>
  <status>ERROR</status>
  <error_code>AUTH_FAILED</error_code>
  <error_description>Invalid username or password</error_description>
</result>

TANIMLAR

GENERAL_ERROR: Bilinmeyen API komutu. Mevcut komutlar: sendsms, delivery_report, userinfo, addoriginator.

XML_ERROR: XML Post parametresi boş veya geçersiz.

AUTH_FAILED: Hatalı kullanıcı adı veya şifre.

USER_DENIED: Erişim engellendi.

EMPTY_ORIGINATOR: originator parametresi boş.

BANNED_ORIGINATOR: Başlık kullanılamaz.

WAITING_ORIGINATOR: Başlık zaten onay bekliyor.

ORIGINATOR_USED: Başlık zaten kullanımda.