API dokumentáció

Hogyan küldjek SMS-t az API-n keresztül?

username - Felhasználónév
password - Jelszó
sender - SMS küldő
def_time - Tömeges SMS küldés ideje, ha nincs meghatározva, akkor az aktuális idő lesz használva
id - A ügyfél által generált opcionális egyedi SMS azonosító, azonosítás a szállítási igazolásokhoz HTTP GET/POST módszerrel
name - Opcionális ügyfél neve
idc - Opcionális ügyfélazonosító, a szállítási igazolások CSV, XLS exportálásához
send_time - SMS küldési idő, felső def_time
unicode - Az SMS diakritikus karakterekkel lesz elküldve
phone - Telefonszám
text - SMS szövege
callback - Egy SMS szállítási igazolása elküldésre kerül a meghatározott URL-re. Szükséges egyedi üzenetazonosító definiálása az SMS szállítási állapotának későbbi hozzárendeléséhez

Príklad odoslania SMS

<?php 
define('XML_PAYLOAD', '<?xml version="1.0" encoding="UTF-8"?>
<sms>
    <credential>
        <username>username</username>
        <password>password or API key</password>
    </credential>
      <message>
        <sender>mycompany</sender>
        <def_time>2016-12-31 23:59:00</def_time>
        <recipients>
         <recipient>
            <id>121</id>  
            <unicode>0</unicode>
            <phone>421911123456</phone>
            <text>Text first SMS</text>
        </recipient>
            <recipient>
             <id>122</id>
             <send_time>2017-12-31 23:59:00</send_time>
             <unicode>1</unicode>
             <phone>421944123456</phone>
            <text>Text SMS 2 unicode čžýáíáť</text>
            </recipient>
            <recipient>
             <id>123</id>
             <name>Janko Hraško</name>
             <idc>12345</idc>
             <send_time></send_time>
             <unicode>0</unicode>
             <phone>42190512346</phone>
             <text>Text 3</text>
            </recipient>
        </recipients>
    </message>
    <optional>
             <callback>https://www.domain.com/sms/callback.php</callback>
    </optional>
</sms>'); 
define('XML_POST_URL', 'https://www.affilsms.com/api/sms-xml/'); 
$ch = curl_init(); 
curl_setopt($ch, CURLOPT_URL, XML_POST_URL); 
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_TIMEOUT, 60); 
curl_setopt($ch, CURLOPT_POSTFIELDS, XML_PAYLOAD); 
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Connection: close')); 
$result = curl_exec($ch); 
if (curl_errno($ch) ) 
{ 
$result = 'ERROR -> ' . curl_errno($ch) . ':' . curl_error($ch); 
} 
else 
{ 
$returnCode = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE); 
switch($returnCode) 
   { 
   case 200: $xmlObject = new SimpleXMLElement($result);   
             $status = $xmlObject->status; 
             $balance = $xmlObject->balance; 
             $errorsms = $xmlObject->errorsms;
             $failedsms = $xmlObject->failedsms;  
   break; 
   case 404: 
   $result = 'ERROR -> 404'; 
   break; 
   default: 
       } 
} 
curl_close($ch); 

?> 
 

 

XML válasz

<response>
<status>1</status>
<balance>64.2454</balance>
<sentsms>3</sentsms>
<errorsms></errorsms>
<failedsms></failedsms>
</response>

 

állapot

1 beérkező hívás

- 1 hibás bejelentkezési adatok

sentsms sikeresen fogadott SMS-ek száma a rendszerben

errorsms nem küldött SMS-ek száma hibás számok miatt

failedsms nem küldött SMS-ek száma alacsony kredites miatt

 

 

-

status: status=delivered, undelivered

id: id=123456