SMS API لموقعك أو تطبيقك.

المصادقة

افتح مفاتيح API داخل حسابك وانسخ المفتاح الذي يبدأ بـ sk_live_. خزّنه على الخادم فقط ولا تضعه في JavaScript عام.

Authorization: Bearer sk_live_YOUR_KEY
Content-Type: application/json

إرسال رسالة SMS

الحقل to يستخدم صيغة E.164. للأرقام السورية ابدأ بـ +963 ثم الرقم من دون صفر البداية المحلي.

{
  "to": "+9639XXXXXXXX",
  "sender_id": "MYSHOP",
  "message": "تم تأكيد طلبك وسيصلك تحديث عند التجهيز."
}

معرّف المرسل Sender ID

يمكنك تغييره لكل طلب API ولكل رسالة من لوحة الحساب. استخدم 2–11 حرفاً لاتينياً أو رقماً من دون مسافات، أو معرّفاً رقمياً حتى 16 خانة. بعض الدول والشبكات تفرض تسجيل أو استبدال Sender ID، لذلك القبول النهائي يعتمد على المسار وشركة الاتصالات.

مثال cURL

curl -X POST "https://smssyria.net/api/v1/messages" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to":"+9639XXXXXXXX",
    "sender_id":"MYSHOP",
    "message":"تم تأكيد طلبك"
  }'

مثال PHP

<?php
$payload = [
  'to' => '+9639XXXXXXXX',
  'sender_id' => 'MYSHOP',
  'message' => 'تم تأكيد طلبك'
];

$ch = curl_init('https://smssyria.net/api/v1/messages');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer sk_live_YOUR_KEY',
    'Content-Type: application/json'
  ],
  CURLOPT_POSTFIELDS => json_encode($payload)
]);

$response = curl_exec($ch);
curl_close($ch);

الاستجابة والرصيد

{
  "ok": true,
  "message_id": "77229318510",
  "status": "sent",
  "sender_id": "MYSHOP",
  "recipient": "+9639XXXXXXXX",
  "cost": 0.20
}