JSON REST API לשליחת מסרונים ואימייל – מדריך מלא
מסר 10 מציעה ממשק REST API מבוסס JSON המאפשר שילוב מהיר ופשוט עם כל מערכת חיצונית — אפליקציות, אתרים, מערכות CRM ועוד. ה-API תומך בשליחת מסרונים, יציר
מסר 10 מציעה ממשק REST API מבוסס JSON המאפשר שילוב מהיר ופשוט עם כל מערכת חיצונית — אפליקציות, אתרים, מערכות CRM ועוד. ה-API תומך בשליחת מסרונים, יצירת אנשי קשר ועדכון סטטוסים בכמה שורות קוד.
כתובת הבסיס ואימות
כל בקשה נשלחת לכתובת הבאה, כאשר מחליפים את FunctionName בשם הפונקציה הרצויה:
https://illogin.mesereser.com/Services/JsonServices.aspx?f=FunctionName
אימות: כל בקשה חייבת לכלול Header בשם ApiKey עם ערך מפתח ה-API שלך. את המפתח ניתן לאחזר מהגדרות המשתמש בממשק מסר 10.
מבנה התגובה הסטנדרטי
כל תגובה מה-API כוללת את השדות ErrorCode ו-Result. ערך 0 ב-ErrorCode מציין הצלחה; כל ערך אחר מציין שגיאה עם תיאור ב-Result:
{
"ErrorCode": 0,
"Result": "Call successful"
}
פונקציות ה-API הזמינות
SendSingleSmsMessage – שליחת מסרון בודד
שולח מסרון SMS בודד למספר טלפון ספציפי. מתאים לאימות OTP, התראות ועדכונים בזמן אמת.
POST /JsonServices.aspx?f=SendSingleSmsMessage
Header: ApiKey: YOUR_API_KEY
Content-Type: application/json
{
"FromName": "שם השולח",
"MessageBody": "תוכן המסרון",
"ToPhone": "0501234567"
}
תגובה:
{
"ErrorCode": 0,
"Result": "",
"MessageID": 12345
}
CreateContact – יצירת איש קשר חדש
מוסיף איש קשר חדש למאגר הרשימות שלך, כולל שדות מותאמים אישית.
POST /JsonServices.aspx?f=CreateContact
Header: ApiKey: YOUR_API_KEY
{
"FirstName": "ישראל",
"LastName": "ישראלי",
"EMail": "israel@example.com",
"PhoneNo": "0501234567",
"ContactListName": "שם הרשימה",
"Address": "",
"City": "",
"Zipcode": "",
"CustomField1": "",
"CustomField2": "",
"CustomField3": "",
"CustomField4": "",
"CustomField5": ""
}
ChangeContactStatus – שינוי סטטוס איש קשר
מעדכן את סטטוס איש קשר לפי כתובת אימייל או מספר טלפון. הסטטוסות הזמינים: Active, Unsubscribed, Bounced.
POST /JsonServices.aspx?f=ChangeContactStatus
{
"EMail": "israel@example.com",
"PhoneNo": "",
"Status": "Unsubscribed"
}
SendSingleEMailMessage – שליחת אימייל בודד
שולח אימייל בודד לנמען ספציפי עם גוף HTML מותאם אישית.
POST /JsonServices.aspx?f=SendSingleEMailMessage
{
"FromName": "שם השולח",
"ReplyToEMail": "reply@example.com",
"ToEMail": "customer@example.com",
"Subject": "נושא האימייל",
"Body": "שלום!
תוכן האימייל...
",
"LinkClickCountType": ""
}
תגובה:
{
"ErrorCode": 0,
"Result": "",
"MessageID": 67890
}
טיפים לשימוש נכון ב-API
- שמרו את ה-ApiKey בסביבה מאובטחת (משתנה סביבה, לא בקוד)
- בדקו תמיד את
ErrorCodeבתגובה לפני שמשתמשים בתוצאה - לשליחת מסרונים בכמות גדולה — השתמשו ב-SOAP API לקמפיינים
- מספר הטלפון צריך להיות בפורמט ישראלי: 05XXXXXXXX או +9725XXXXXXXX
מוכנים להתחיל?
הרשמו עכשיו למסר 10 וקבלו גישה מיידית ל-API, לממשק שליחת המסרונים ולכלי הדיוור המתקדמים שלנו.