שליחת הודעות SMS באמצעות 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
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
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
$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
}
לפרטים נוספים נא צרו איתנו קשר