API לשליחת SMS

שליחת הודעות SMS באמצעות API

מפתח ה- API שלך הוא:

מפתח יקר,
לפני השליחה נא שים לב:

1. לפני שליחה ראשונה - חובה לבצע אימות ראשוני של מספר השולח, על ידי שליחת הודעת סמס אחת ידנית מתוך דף השליחה באתר.

2. ניתן לשנות את פרטי השולח בשדה Sender רק לאחר רכישת חבילת סמסים כלשהי.
עם 10 ההודעות החינמיות הראשונות ניתן לשלוח רק כשבשדה sender מופיע מספר הנייד איתו נרשמת.

3. אם קיבלת לאחר נסיון השליחה קוד שגיאה - תוכל לראות בהמשך דף זה הסבר לגבי הקוד.

לשליחת הודעות SMS באמצעות התממשקות API עליכם לשלוח את הפרמטרים בטבלה למטה אל הכתובת:

https://api.sms4free.co.il/ApiSMS/v2/SendSMS
את הפרמטרים יש לשלוח באמצעות מתודת הבקשה POST

יש להשתמש ב Content-Type: application/json

שם הפרמטר ערך תיאור
key
מפתח ה- API שלכם
user תווים המספר הסלולרי איתו אתם מתחברים לאתר
pass תווים הסיסמה איתה אתם מתחברים לאתר
sender מספרים או תווים באנגלית, עד 11 תווים ערך זה יוצג כשם או כמספר הטלפון של שולח ההודעה
recipient תווים שימת מספרי הטלפון הסלולרים של הנמענים, מופרדים ע"י התו;
msg תווים או מספרים תוכן ההודעה אותה תרצו לשלוח

את התשובה מהמערכת אתם תקבלו כאובייקט שמורכב מ-"status" המכיל מספר ו "message" שמכיל תיאור על ״status" , להלן תיאור הערכים:

מספר גדול מ-0 : ההודעה נשלחה בהצלחה אל מספר זה של נמענים

שגיאה כללית : 0

מפתח, שם משתמש או סיסמה שגויים : 1-

שם או מספר שולח ההודעה שגוי : 2-

לא נמצאו נמענים : 3-

לא ניתן לשלוח הודעה, יתרת הודעות פנויות נמוכה : 4-

הודעה לא מתאימה : 5-

צריך לאמת מספר שולח : 6-

בנוסף, באפשרותכם לבדוק את מספר ההודעות הפנויות בחשבונכם ע"י פנייה לכתובת:

https://api.sms4free.co.il/ApiSMS/AvailableSMS
את הפרמטרים יש לשלוח באמצעות מתודת הבקשה POST
יש להשתמש ב Content-Type: application/json

שם הפרמטר ערך תיאור
key
מפתח ה- API שלכם
user תווים המספר הסלולרי איתו אתם מתחברים לאתר
pass תווים הסיסמה איתה אתם מתחברים לאתר

דוגמאות לשימוש ב API

#C

HttpClient client = new HttpClient();
string key = "YOUR_API_KEY";
string user = "YOUR_PHONE_NUMBER";
string pass = "YOUR_PASSWORD";
string sender = "SENDER";
string recipient = "0512345678; 0512345678"; // Numbers must be separated with ;
string msg = "SMS4FREE"; // can be anything

var requestObject = new
{
key,
user,
pass,
sender,
recipient,
msg
};

var dataAsJson = JsonConvert.SerializeObject(requestObject);
var buffer = Encoding.UTF8.GetBytes(dataAsJson);

var byteContent = new ByteArrayContent (buffer);
byteContent. Headers.ContentType = new MediaTypeHeaderValue("application/json");

var response = client.PostAsync("https://api.sms4free.co.il/ApiSMS/v2/SendSMS", byteContent).Result;
var responseString = response.Content.ReadAsStringAsync().Result;
Console.WriteLine(responseString); // Gives you how many recipients the message was sent to
                        
Python

import requests
url="https://api.sms4free.co.il/ApiSMS/v2/SendSMS"
key="YOUR_API_KEY"
user="YOUR_PHONE_NUMBER"
password="YOUR_PASSWORD"
sender="SENDER"
recipient="0512345678; 0512345678" # Numbers must be seperated with ;
msg="test" # can be anything
data={}
data["key"]=key
data["user"]=user
data["sender"]=sender
data["pass"]=password
data["recipient"]=recipient
data["msg"]=msg

response=requests.post(url, json=data)
print(response.text) #Gives you how many recipients the message was sent to
                                        
PHP

$url = "https://api.sms4free.co.il/ApiSMS/v2/SendSMS";
$key = "YOUR_API_KEY";
$user = "YOUR_PHONE_NUMBer";
$pass = "YOUR_PASSWORD";
$sender = "SENDER";
$recipient = "0512345678;0512345678"; // Numbers must be seperated with ;
$msg = "message"; # can be anything

// $postdata =
array(
'key' => $key,
'user' => $user,
'pass' => $pass,
'sender' => $sender,
'recipient' => $recipient,
'msg' => $msg
);
$data_string = json_encode($postdata);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 0);
curl_setopt($ch, CURLOPT_TIMEOUT, 400);
set_time_limit(0);

$data = curl_exec($ch);
$curl_errno = curl_errno($ch);
$curl_error = curl_error($ch);
curl_close($ch);

if ($curl_errno > 0) {
echo "CURL Error ($curl_errno): $curl_error\n";
} else {
echo "Data received: $data\n"; // Gives you how many recipients the message was sent to
}
                                                        

לפרטים נוספים נא צרו איתנו קשר

מידע השירותים שלנו

מספר וירטואלי

SMS לחו"ל

רגולציה 2020 זיהוי שולח

SMS חינם

SMS לעסקים

שליחת SMS באמצעות API

צירוף קובץ
ל- SMS

SMS חסוי

מספר וירטואלי לטלפון כשר

הודעות מותאמות אישית