نقطة نهاية إرسال الرسائل القصيرة

نقطة نهاية REST API لإرسال الرسائل القصيرة عبر إضافة WSMS.

تتيح لك نقطة النهاية هذه إرسال الرسائل القصيرة عبر الإضافة. استخدمها لإرسال رسائل SMS إلى مستلم واحد أو أكثر برمجياً.

نقطة النهاية

POST /wp-json/wpsms/v1/send

معاملات الطلب

المعامل	النوع	مطلوب	الوصف
`sender`	string	لا	معرف المرسل أو رقم الهاتف
`recipients`	string/array	نعم	أرقام الهواتف أو `"subscribers"` للإرسال إلى مجموعات المشتركين
`group_ids`	array	لا	مصفوفة معرفات مجموعات المشتركين (عندما تكون recipients هي `"subscribers"`)
`message`	string	نعم	محتوى الرسالة القصيرة
`media_urls`	array	لا	مصفوفة عناوين URL للوسائط لرسائل MMS

أمثلة

cURL

curl --location --request POST 'https://site.com/wp-json/wpsms/v1/send' \
--header 'Content-Type: application/json' \
--data-raw '{
   "sender": "+15058713629",
   "recipients": "subscribers",
   "group_ids": [13, 4],
   "message": "Hello!",
   "media_urls": [
      "https://site.com/image.jpg"
   ]
}'

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://site.com/wp-json/wpsms/v1/send',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
    'sender' => '+15058713629',
    'recipients' => 'subscribers',
    'group_ids' => [13, 4],
    'message' => 'Hello!',
    'media_urls' => ['https://site.com/image.jpg']
  ]),
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;

الاستجابة

نجاح

{
   "message": "Successfully send SMS!",
   "error": [],
   "data": {
      "balance": 2
   }
}

الحقل	النوع	الوصف
`message`	string	رسالة النجاح
`error`	array	مصفوفة الأخطاء (فارغة عند النجاح)
`data.balance`	number	رصيد الرسائل القصيرة المتبقي

المصادقة

تتطلب نقطة النهاية هذه المصادقة. تأكد من أن طلبك يتضمن بيانات اعتماد صالحة لمصادقة WordPress أو مفتاح API.