חיבור API לשליחת מסרונים – מדריך טכני שלב אחר שלב
מבוא מדריך זה מיועד למפתחים שרוצים לשלב שליחת SMS ב-API של מסר 10 במערכת שלהם. נסקור את כל שלבי החיבור מהרשמה ועד שליחת ההודעה הראשונה. שלב 1: הרשמה
מבוא
מדריך זה מיועד למפתחים שרוצים לשלב שליחת SMS ב-API של מסר 10 במערכת שלהם. נסקור את כל שלבי החיבור מהרשמה ועד שליחת ההודעה הראשונה.
שלב 1: הרשמה וקבלת מפתח API
לפני שמתחילים, יש להירשם לחשבון מסר 10 ולקבל מפתח API:
- היכנסו ל-meser10.co.il ולחצו על "כניסת לקוחות"
- עברו להגדרות חשבון ← API
- העתיקו את מפתח ה-API שלכם
שלב 2: נקודת הקצה
שליחת מסרון בודד נעשית בבקשת POST בפורמט JSON לכתובת:
POST https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleSmsMessage
מפתח ה-API נשלח בכותרת ApiKey, לא בגוף הבקשה. כדאי לשלוח גם כותרת User-Agent עם שם האפליקציה שלכם.
שלב 3: שדות הבקשה
ToPhone: מספר הטלפון של הנמען, למשל 0501234567MessageBody: תוכן ההודעה. בעברית מסרון בודד הוא עד 70 תווים, ובהודעה מפוצלת 67 תווים לכל חלק. באותיות לטיניות 160 תוויםFromName: שם השולח שאושר בחשבון
שלב 4: דוגמת קוד ב-PHP
<?php
$apiKey = getenv('MESER10_API_KEY');
$body = json_encode([
'ToPhone' => '0501234567',
'MessageBody' => 'שלום! הזמנתך #1234 אושרה.',
'FromName' => 'MyShop',
], JSON_UNESCAPED_UNICODE);
$ch = curl_init('https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleSmsMessage');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $body,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'ApiKey: ' . $apiKey,
'Content-Type: application/json; charset=utf-8',
'User-Agent: my-app/1.0',
],
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['ErrorCode'] === 0) {
echo 'נשלח';
} else {
echo 'שגיאה: ' . $result['Result'];
}
?>
שלב 5: דוגמת קוד ב-Python
import os
import requests
response = requests.post(
'https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleSmsMessage',
headers={
'ApiKey': os.environ['MESER10_API_KEY'],
'User-Agent': 'my-app/1.0',
},
json={
'ToPhone': '0501234567',
'MessageBody': 'שלום! הזמנתך אושרה.',
'FromName': 'MyShop',
},
)
result = response.json()
if result['ErrorCode'] == 0:
print('נשלח')
else:
print('שגיאה:', result['Result'])
שלב 6: קריאת התשובה
התשובה היא JSON. קוד HTTP 200 לא אומר שההודעה נשלחה, ההצלחה נקבעת לפי השדות בגוף התשובה:
ErrorCode: הערך 0 אומר שהבקשה הצליחה. כל ערך אחר הוא שגיאהResult: תיאור התוצאה או השגיאהMessageID: מזהה ההודעה
טיפים חשובים
- אל תכניסו את מפתח ה-API ישירות בקוד. שמרו אותו במשתנה סביבה או בקובץ הגדרות (.env)
- בדקו את
ErrorCodeבכל תשובה לפני שממשיכים - לשליחת הודעות בעברית, ודאו שהקידוד הוא UTF-8
תיעוד מלא
לכל הפונקציות והשדות של הממשק, בקרו בדף תיעוד ה-API.