חיבור API לשליחת מסרונים – מדריך טכני שלב אחר שלב

מבוא מדריך זה מיועד למפתחים שרוצים לשלב שליחת SMS ב-API של מסר 10 במערכת שלהם. נסקור את כל שלבי החיבור מהרשמה ועד שליחת ההודעה הראשונה. שלב 1: הרשמה

מבוא

מדריך זה מיועד למפתחים שרוצים לשלב שליחת SMS ב-API של מסר 10 במערכת שלהם. נסקור את כל שלבי החיבור מהרשמה ועד שליחת ההודעה הראשונה.

שלב 1: הרשמה וקבלת מפתח API

לפני שמתחילים, יש להירשם לחשבון מסר 10 ולקבל מפתח API:

  1. היכנסו ל-meser10.co.il ולחצו על "כניסת לקוחות"
  2. עברו להגדרות חשבון ← API
  3. העתיקו את מפתח ה-API שלכם

שלב 2: נקודת הקצה

שליחת מסרון בודד נעשית בבקשת POST בפורמט JSON לכתובת:

POST https://heb.mesereser.com/Services/JsonServices.aspx?f=SendSingleSmsMessage

מפתח ה-API נשלח בכותרת ApiKey, לא בגוף הבקשה. כדאי לשלוח גם כותרת User-Agent עם שם האפליקציה שלכם.

שלב 3: שדות הבקשה

שלב 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 לא אומר שההודעה נשלחה, ההצלחה נקבעת לפי השדות בגוף התשובה:

טיפים חשובים

תיעוד מלא

לכל הפונקציות והשדות של הממשק, בקרו בדף תיעוד ה-API.

מוכנים לשפר את התוצאות?

הצטרפו לאלפי עסקים שכבר משתמשים ב-Meser10

התחל עכשיו בחינם