توثيق الرسائل القصيرة
في SMSmobileAPI، نسعى جاهدين لجعل واجهة برمجة التطبيقات الخاصة بنا متوافقة قدر الإمكان مع أي بنية أو منصة.
سواء كنت تستخدم REST أو SOAP أو cURL أو لغات برمجة مختلفة مثل Python و JavaScript و PHP وغيرها، فقد تم تصميم واجهة برمجة التطبيقات الخاصة بنا لتتكامل بسلاسة مع مشاريعك.
لدينا أيضًا مكونات إضافية جاهزة للاستخدام لحلول وبرامج التجارة الإلكترونية. انقر هنا لاكتشافهم.
إرسال رسالة نصية قصيرة
تتيح لك هذه النقطة النهائية إرسال رسالة نصية قصيرة من هاتفك المحمول.نقطة النهاية:
حدود:
| المعلمة | وصف |
|---|---|
| apikey | مطلوب مفتاح API الفريد الخاص بك. |
| recipients | مطلوب رقم هاتف المستلم. |
| message |
مطلوب
الرسالة المراد إرسالها (طول الرسالة غير محدود بـ 160 حرفًا؛ يمكنك إرسال رسائل أطول)
|
| shorturl |
1 = سيتم تحويل جميع عناوين URL في الرسالة تلقائيًا إلى عناوين URL مختصرة صفر أو فارغ = لن يتم تحويل عناوين URL إلى عناوين URL مختصرة |
| sIdentifiant |
إذا كان لديك أكثر من هاتف متصل بحسابك، فحدد الهاتف الذي سيرسل الرسالة النصية. لكل هاتف مُعرّف فريد - استخدم هذا المُعرّف لاختيار الجهاز. اتركه فارغًا للسماح لأول هاتف متاح بإرسال الرسالة النصية، أو إذا كان لديك هاتف واحد فقط متصل.
تحتاج إلى إصدار التطبيق 3.0.35.3 أو أعلى للوصول إليه. |
| sendwa | 1=يجب إرسال الرسالة عبر الواتساب. |
| sendsms |
1= يجب إرسال الرسالة عبر رسالة نصية قصيرة تقليدية. (لو يرسل رسالة نصية قصيرة فارغ: تم إرساله افتراضيًا، تم ضبطه على 0 لحظر الرسائل القصيرة) |
| encrypt_message |
نعم =سيتم تشفير الرسالة عند قراءتها من قبل المستلم. سيحتاج المستلم إلى إدخال مفتاح فريد لفك تشفير الرسالة. تعرف على المزيد حول تشفير الرسائل |
| schedule_timestamp | يمثل الوقت الذي يجب إرسال الرسالة النصية القصيرة منه - يجب أن يكون طابع زمني UNIX (توقيت جرينتش 0) |
مثال:
GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld
إعادة إرسال رسالة نصية قصيرة غير مرسلة
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لإعادة إرسال رسالة نصية قصيرة غير مرسلة (فقط إذا كانت الرسالة تحتوي على حالة خطأ)
نقطة النهاية:
المعلمة:
| المعلمة | وصف |
|---|---|
| guid | مطلوب GUID للرسالة التي سيتم إعادة إرسالها. |
مثال:
احصل على https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE
سجل الرسائل النصية القصيرة المرسلة من واجهة برمجة التطبيقات
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لاسترداد سجل رسائل SMS المرسلة عبر واجهة برمجة التطبيقات.
نقطة النهاية:
المعلمة:
| المعلمة | وصف |
|---|---|
| apikey | مطلوب مفتاح API الخاص بك. |
| guid_message | مختصر بواسطة معرف فريد للرسالة المستخدمة للفرز والتصفية. |
| before | استرداد الرسائل المرسلة قبل هذا الطابع الزمني أو GUID المحدد. |
| error_api | أدخل 1 لعرض قائمة بجميع الرسائل النصية القصيرة التي واجهت خطأً أثناء طلب واجهة برمجة التطبيقات (API). |
| error_mobile | أدخل 1 لعرض قائمة بجميع الرسائل النصية القصيرة التي واجهت خطأً أثناء معالجة الهاتف المحمول. |
| keyword | كلمة رئيسية لتصفية الرسائل بناءً على رقم المستلم أو محتوى الرسالة النصية القصيرة. |
مثال:
احصل على https://api.smsmobileapi.com/log/sent/sms?apikey=YOUR_API_KEY
تم استلام الرسالة النصية القصيرة
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لاسترداد رسائل SMS المستلمة على الهاتف الذكي.
نقطة النهاية:
المعلمة:
| المعلمة | وصف |
|---|---|
| apikey | مطلوب مفتاح API الذي لديك أو سوف تتلقاه. |
| sIdentifiantPhone | يسمح بعزل رقم الهاتف المرتبط بالرسائل النصية القصيرة المستلمة |
| after_timestamp_unix | أدخل "الطابع الزمني" يسمح بإدراج رسائل SMS المستلمة بعد طابع زمني UNIX معين |
| onlyunread | أدخل "نعم" يسمح بإدراج رسائل SMS فقط التي لم يتم وضع علامة عليها كمقروءة بعد (وفقًا لحالة واجهة برمجة التطبيقات). |
مثال:
احصل على https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY
وضع علامة على رسائل SMS المستلمة كمقروءة
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لتمييز رسالة SMS واحدة أو رسائل SMS متعددة مستلمة على أنها مقروءة في حالة واجهة برمجة التطبيقات فقط.
يعني هذا أن حالة القراءة يتم تحديثها على جانب واجهة برمجة التطبيقات، مما يساعدك على تصفية الرسائل التي تمت معالجتها بالفعل عند استخدام مرشح onlyunread=yes.
مهم:
لا يؤثر هذا الإجراء على حالة القراءة على الهاتف الذكي نفسه - ينطبق التغيير فقط على حالة واجهة برمجة التطبيقات، وليس على تطبيق المراسلة أو حالة النظام على الجهاز.
نقطة النهاية:
المعلمة:
| المعلمة | وصف |
|---|---|
| apikey | مطلوب مفتاح API الذي لديك أو سوف تتلقاه. |
| guid_message | مطلوب GUID للرسالة التي سيتم وضع علامة عليها كمقروءة |
مثال:
احصل على https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE
حذف الرسائل النصية القصيرة
يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لحذف رسائل SMS من سجل خادم SMS Mobile API
نقطة النهاية:
المعلمة:
| المعلمة | وصف |
|---|---|
| apikey | مطلوب مفتاح API الذي لديك. |
| guid_message | المعرف الفريد للرسالة التي يجب حذفها. |
| date_start | إذا تم استخدامه بمفرده، فسيتم حذف جميع الرسائل من اليوم المحدد. |
| date_start and date_end | مشترك لحذف الرسائل خلال فترة زمنية محددة. |
مثال:
احصل على https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY
ملاحظة: الرسائل النصية المحذوفة هي فقط تلك المخزنة في سجلات حساب تطبيقك على الهاتف. لن تُحذف الرسائل النصية الموجودة على جهازك نفسه، لأننا لا نملك صلاحية الوصول إليها.
Webhook – الرسائل القصيرة المستلمة
يرسل نظام webhook هذا طلب POST إلى عنوان URL المُهيأ كلما تم استلام رسالة نصية قصيرة. ويضمن النظام التحديثات في الوقت الفعلي من خلال تسليم تفاصيل الرسائل النصية القصيرة إلى عنوان URL الخاص بـ webhook المحدد.
كيفية تكوين Webhook في لوحة المعلومات
اتبع الخطوات التالية لإعداد عنوان URL الخاص بـ webhook في لوحة المعلومات:
- قم بتسجيل الدخول إلى حسابك على لوحة معلومات واجهة برمجة تطبيقات SMS Mobile.
- انتقل إلى إعدادات الويب هوك قسم.
- أدخل عنوان URL لخطاف الويب الخاص بك (على سبيل المثال،
https://example.com/webhook-endpoint). - انقر على حفظ Webhook زر.
- بمجرد الحفظ، سيبدأ النظام في إرسال تفاصيل الرسائل القصيرة إلى عنوان URL الذي تم تكوينه.
حمولة الويب هوك
عند استلام رسالة نصية قصيرة، يرسل النظام الحمولة JSON التالية إلى عنوان URL الخاص بـ webhook الخاص بك:
{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "مرحباً، هذه رسالة اختبار.", "number": "+123456789", "guid": "abcde12345" }
حقول الحمولة:
- تاريخ: التاريخ الذي تمت فيه إضافة الرسائل القصيرة (YYYY-MM-DD).
- ساعة: الساعة التي تمت فيها إضافة الرسالة النصية القصيرة (ساعة:دقيقة:ثانية).
- الوقت المستلم: الوقت الذي تم فيه استلام الرسالة النصية القصيرة.
- رسالة: محتوى الرسالة النصية القصيرة.
- رقم: رقم هاتف المرسل.
- الدليل: معرف فريد للرسالة القصيرة.
مثال على نقطة نهاية Webhook
يجب أن يكون الخادم جاهزًا للتعامل مع طلبات POST الواردة. فيما يلي مثال لنص PHP لمعالجة حمولة webhook:
اختبار Webhook
لاختبار تكوين خطاف الويب الخاص بك، استخدم أدوات مثل:
استكشاف الأخطاء وإصلاحها
- تأكد من أن عنوان URL الخاص بـ webhook صحيح ويمكن الوصول إليه علنًا.
- تأكد من أن الخادم الخاص بك يقوم بإرجاع رمز الحالة HTTP 200 للطلبات الناجحة.
- تحقق من سجلات الخادم لديك بحثًا عن أي أخطاء في معالجة الحمولة.
الرسائل النصية القصيرة المُحسّنة
قريباًالمصادقة
تدعم واجهة برمجة تطبيقات SMSMobile طريقتين للمصادقة: استخدام مفتاح API بسيط أو بروتوكول OAuth2 مع معرف العميل وسر العميل.
1. مصادقة مفتاح API
تتطلب هذه الطريقة مفتاح API يمكن تضمينه كمعلمة في طلب GET أو POST. إنها طريقة مباشرة للتحقق من صحة طلبات API الخاصة بك.
2. مصادقة OAuth2
يوفر OAuth2 طريقة مصادقة أكثر أمانًا وقابلة للتطوير.
سوف تحتاج إلى استخدام معرف العميل وسر العميل للحصول على رمز وصول، والذي يجب تضمينه بعد ذلك في طلبات واجهة برمجة التطبيقات الخاصة بك باستخدام التفويض رأس الصفحة.
يتوفر معرف العميل وسر العميل في لوحة التحكم الخاصة بك، ويمكن الوصول إليهما بعد تثبيت التطبيق وإنشاء حساب على جهازك المحمول.
قم بتنزيل التطبيق المحمول الآن أو
ادخل إلى لوحة التحكم الخاصة بك.
الحصول على رمز الوصول
للحصول على رمز وصول، أرسل طلب POST إلى نقطة نهاية الرمز باستخدام معرف العميل والسر الخاص بالعميل.
curl -X POST https://api.smsmobileapi.com/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=1ab0ex4b4c1ef2c800690d" \
-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"
استخدام رمز الوصول:
بمجرد حصولك على رمز الوصول، قم بتضمينه في التفويض رأس طلبات واجهة برمجة التطبيقات الخاصة بك:
curl -X POST https://api.smsmobileapi.com/sendsms \
-H "التفويض: الناقل abc123xyz456" \
-H "نوع المحتوى: application/x-www-form-urlencoded" \
-d "المستلمون=+1234567890" \
-d "الرسالة=مرحبا"
ما هي الطريقة التي يجب عليك استخدامها؟
- يستخدم مصادقة مفتاح API للتكامل السريع والمباشر.
- يستخدم مصادقة OAuth2 لتعزيز الأمان وقابلية التوسع في عمليات التكامل الخاصة بك.
لمزيد من التفاصيل، يرجى الرجوع إلى الوثائق الكاملة.
إرسال رسالة نصية قصيرة
عنوان URL لـ WSDL
حدود:
- message: الرسالة المراد إرسالها. (طول الرسالة غير محدود بـ 160 حرفًا؛ يمكنك إرسال رسائل أطول)
- apikey: مفتاح API الذي لديك أو سوف تتلقاه.
مثال
require_once "lib/nusoap.php";
$client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);
$error = $client->getError();
$result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));
print_r($result);
إرسال الرسائل القصيرة وواتساب
أمر cURL الأساسي
بإمكانك استخدام أمر cURL التالي لإرسال رسالة نصية قصيرة عبر SMSmobileAPI:
curl -X POST https://api.smsmobileapi.com/sendsms/ \
-d "recipients=PHONE_NUMBER" \
-d "message=YOUR_MESSAGE" \
-d "apikey=YOUR_API_KEY"
-d "sendwa=1"
-d "sendsms=1"
مثال cURL في PHP
إذا كنت تستخدم PHP، فإليك كيفية إرسال رسالة نصية قصيرة باستخدام cURL:
<?php
$url = 'https://api.smsmobileapi.com/sendsms/';
$data = array(
'recipients' => 'PHONE_NUMBER',
'message' => 'YOUR_MESSAGE',
'apikey' => 'YOUR_API_KEY',
'sendwa' => '1',
'sendsms' => '1'
);
$options = array(
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($data),
CURLOPT_RETURNTRANSFER => true,
);
$ch = curl_init();
curl_setopt_array($ch, $options);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
يوضح مثال PHP هذا كيفية إرسال طلب POST باستخدام cURL إلى SMSmobileAPI، وتمرير المعلمات الضرورية كمصفوفة ارتباطية.
إرسال الرسائل القصيرة وواتساب
استخدم وحدة Python الرسمية الخاصة بنا: https://smsmobileapi.com/python/
أو استخدم الطريقة اليدوية ...
باستخدام الطلبات مكتبة
ال الطلبات مكتبة `library` هي مكتبة HTTP شائعة وبسيطة للغة بايثون. إليك كيفية استخدامها لإرسال رسالة نصية قصيرة عبر واجهة برمجة تطبيقات الرسائل النصية القصيرة عبر الهاتف المحمول (SMSmobileAPI):
import requests
url = "https://api.smsmobileapi.com/sendsms/"
payload = {
"recipients": "PHONE_NUMBER",
"message": "YOUR_MESSAGE",
"apikey": "YOUR_API_KEY"
}
response = requests.post(url, data=payload)
print(response.text)
باستخدام http.client مكتبة
ال http.client تُعدّ هذه المكتبة جزءًا من المكتبة القياسية للغة بايثون، ويمكن استخدامها أيضًا للتفاعل مع واجهة برمجة التطبيقات (API) الخاصة بك:
import http.client
import urllib.parse
conn = http.client.HTTPSConnection("api.smsmobileapi.com")
params = urllib.parse.urlencode({
"recipients": "PHONE_NUMBER",
"message": "YOUR_MESSAGE",
"apikey": "YOUR_API_KEY"
})
headers = { "Content-type": "application/x-www-form-urlencoded" }
conn.request("POST", "/sendsms/", params, headers)
response = conn.getresponse()
data = response.read()
print(data.decode("utf-8"))
conn.close()
SMS Mobile API - PHP SDK (Composer)
تتوفر مجموعة أدوات تطوير البرامج PHP الخاصة بـ SMS Mobile API عبر Composer، مما يجعل من السهل دمج إرسال الرسائل القصيرة في تطبيقات PHP الخاصة بك.يتطلب الملحن smsmobileapi/sdk
للحصول على توثيق مفصل وتعليمات التثبيت وأمثلة الاستخدام، تفضل بزيارة مستودع GitHub الخاص بنا:
🔗 SMS Mobile API PHP SDK على GitHub: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main
ستجد على GitHub:
✔️ دليل التثبيت الكامل
✔️ مثال على الاستخدام
✔️ مرجع واجهة برمجة التطبيقات وأفضل الممارسات
هل تحتاج إلى مساعدة؟ لا تتردد في فتح مشكلة على GitHub! 🎯
إرسال الرسائل القصيرة وواتساب
باستخدام أحضر واجهة برمجة التطبيقات
ال أحضر تُعدّ واجهة برمجة التطبيقات (API) طريقة حديثة ومتعددة الاستخدامات لإجراء طلبات HTTP في جافا سكريبت. إليك كيفية استخدامها لإرسال رسالة نصية قصيرة (SMS) عبر واجهة برمجة تطبيقات الرسائل النصية القصيرة عبر الهاتف المحمول (SMSmobileAPI):
const url = "https://api.smsmobileapi.com/sendsms/";
const data = {
recipients: "PHONE_NUMBER",
message: "YOUR_MESSAGE",
apikey: "YOUR_API_KEY"
};
fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
body: new URLSearchParams(data)
})
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));
استخدام XMLHttpRequest
إذا كنت بحاجة إلى دعم المتصفحات القديمة، يمكنك استخدام XMLHttpRequest هدف:
const xhr = new XMLHttpRequest();
const url = "https://api.smsmobileapi.com/sendsms/";
const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";
xhr.open("POST", url, true);
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
xhr.onreadystatechange = function() {
if (xhr.readyState === 4 && xhr.status === 200) {
console.log(xhr.responseText);
}
};
xhr.send(data);
إرسال الرسائل القصيرة وواتساب
باستخدام أكسيوس مكتبة
ال أكسيوس مكتبة `library` هي عميل HTTP شائع لـ Node.js. إليك كيفية استخدامها لإرسال رسالة نصية قصيرة عبر واجهة برمجة تطبيقات الرسائل النصية القصيرة عبر الهاتف المحمول (SMSmobileAPI):
const axios = require('axios');
const url = 'https://api.smsmobileapi.com/sendsms/';
const data = {
recipients: 'PHONE_NUMBER',
message: 'YOUR_MESSAGE',
apikey: 'YOUR_API_KEY'
};
axios.post(url, data)
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error('Error:', error);
});
إرسال الرسائل القصيرة وواتساب
باستخدام Net::HTTP مكتبة
يمكنك استخدام Net::HTTP مكتبة في لغة روبي لإرسال رسالة نصية قصيرة عبر واجهة برمجة تطبيقات الرسائل النصية القصيرة عبر الهاتف المحمول:
require 'net/http'
require 'uri'
uri = URI.parse("https://api.smsmobileapi.com/sendsms/")
request = Net::HTTP::Post.new(uri)
request.set_form_data(
"recipients" => "PHONE_NUMBER",
"message" => "YOUR_MESSAGE",
"apikey" => "YOUR_API_KEY"
)
req_options = {
use_ssl: uri.scheme == "https",
}
response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
http.request(request)
end
puts response.body

تنشأ هذه المشكلة من عملية تحاول التشغيل في الخلفية عندما لا يتم تشغيل التطبيق بشكل نشط. ومع ذلك، نظرًا لإجراءات تحسين البطارية في Android، والتي تختلف عبر الإصدارات المختلفة، فقد لا يتم تشغيل هذه العملية في الخلفية بشكل صحيح. تم تصميم تحسين البطارية في Android للحد من نشاط التطبيقات في الخلفية للحفاظ على عمر البطارية، وهو ما قد يؤثر عن غير قصد على التطبيقات التي تتطلب عمليات خلفية للعمل بشكل صحيح.
ولمعالجة هذه المشكلة، يمكن للمستخدمين تكوين إعدادات Android يدويًا للسماح لـ SmsMobileApi باستخدام الموارد دون قيود.
يتضمن هذا ضبط إعدادات تحسين البطارية للتطبيق المحدد، مما يعني في الأساس إعطاء تعليمات إلى Android بأن SmsMobileApi مسموح له بالعمل في الخلفية واستخدام الموارد حسب الحاجة. ومن خلال القيام بذلك، يجب أن يكون التطبيق قادرًا على إرسال واستقبال رسائل SMS تلقائيًا حتى عندما لا يكون التطبيق النشط في المقدمة. يضمن هذا التعديل أن العملية الضرورية في الخلفية يمكن أن تعمل دون انقطاع، مما يتجنب ميزات تحسين البطارية التي قد تمنع تنفيذها بشكل صحيح.


الأسئلة الشائعة للمطورين
ابدأ مع SMSmobileAPI اليوم!
استمتع بالحرية والمرونة في إدارة خدمات الرسائل القصيرة الخاصة بك أثناء التنقل. قم بتنزيل تطبيقنا المحمول الآن واتخذ الخطوة الأولى نحو التكامل السلس للرسائل القصيرة.
تنزيل التطبيق