Dev DOC - SMSMobileAPI
توثيق مطور SMSmobileAPI
 

إرسال رسالة نصية قصيرة

تتيح لك هذه النقطة النهائية إرسال رسالة نصية قصيرة من هاتفك المحمول.

نقطة النهاية: 

يحصل بريد https://api.smsmobileapi.com/sendsms/

حدود:

المعلمة وصف
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
ملاحظة: في حالة حدوث خطأ في التسليم بسبب مشغل الخدمة الخاص بك، تقوم وظيفة افتراضية بإعادة محاولة إرسال نفس الرسالة النصية القصيرة حتى 3 مرات خلال فترة زمنية محددة.
 

إعادة إرسال رسالة نصية قصيرة غير مرسلة

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لإعادة إرسال رسالة نصية قصيرة غير مرسلة (فقط إذا كانت الرسالة تحتوي على حالة خطأ)

نقطة النهاية:

يحصل بريد https://api.smsmobileapi.com/resend/

المعلمة: 

المعلمةوصف
guid
مطلوب
GUID للرسالة التي سيتم إعادة إرسالها.

مثال: 

احصل على https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE
 

سجل الرسائل النصية القصيرة المرسلة من واجهة برمجة التطبيقات

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لاسترداد سجل رسائل SMS المرسلة عبر واجهة برمجة التطبيقات.

نقطة النهاية: 

يحصل https://api.smsmobileapi.com/log/sent/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 المستلمة على الهاتف الذكي. 

نقطة النهاية:

يحصل https://api.smsmobileapi.com/getsms/

المعلمة: 

المعلمةوصف
apikey
مطلوب
مفتاح API الذي لديك أو سوف تتلقاه.
sIdentifiantPhone يسمح بعزل رقم الهاتف المرتبط بالرسائل النصية القصيرة المستلمة
after_timestamp_unix أدخل "الطابع الزمني" يسمح بإدراج رسائل SMS المستلمة بعد طابع زمني UNIX معين
onlyunread أدخل "نعم" يسمح بإدراج رسائل SMS فقط التي لم يتم وضع علامة عليها كمقروءة بعد (وفقًا لحالة واجهة برمجة التطبيقات).

مثال:

احصل على https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY
 

وضع علامة على رسائل SMS المستلمة كمقروءة

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لتمييز رسالة SMS واحدة أو رسائل SMS متعددة مستلمة على أنها مقروءة في حالة واجهة برمجة التطبيقات فقط.
يعني هذا أن حالة القراءة يتم تحديثها على جانب واجهة برمجة التطبيقات، مما يساعدك على تصفية الرسائل التي تمت معالجتها بالفعل عند استخدام مرشح onlyunread=yes.

مهم:
لا يؤثر هذا الإجراء على حالة القراءة على الهاتف الذكي نفسه - ينطبق التغيير فقط على حالة واجهة برمجة التطبيقات، وليس على تطبيق المراسلة أو حالة النظام على الجهاز.  

نقطة النهاية:

يحصل https://api.smsmobileapi.com/getsms/set-read/

المعلمة: 

المعلمةوصف
apikey
مطلوب
مفتاح API الذي لديك أو سوف تتلقاه.
guid_message
مطلوب
GUID للرسالة التي سيتم وضع علامة عليها كمقروءة

مثال:

احصل على https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE
 

حذف الرسائل النصية القصيرة

يتم استخدام نقطة نهاية واجهة برمجة التطبيقات هذه لحذف رسائل SMS من سجل خادم SMS Mobile API

نقطة النهاية: 

يحصل https://api.smsmobileapi.com/deletesms/

المعلمة:

المعلمةوصف
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 في لوحة المعلومات:

  1. قم بتسجيل الدخول إلى حسابك على لوحة معلومات واجهة برمجة تطبيقات SMS Mobile.
  2. انتقل إلى إعدادات الويب هوك قسم.
  3. أدخل عنوان URL لخطاف الويب الخاص بك (على سبيل المثال، https://example.com/webhook-endpoint).
  4. انقر على حفظ Webhook زر. 
  5. بمجرد الحفظ، سيبدأ النظام في إرسال تفاصيل الرسائل القصيرة إلى عنوان 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

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

حدود:

- recipients: رقم الهاتف المحمول للمستلم.
- 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 المثبت على الهاتف المحمول، قد يعيق نظام التشغيل الأداء السليم لإرسال واستقبال رسائل SMS تلقائيًا عندما لا يكون تطبيق SmsMobileApi في المقدمة.
تنشأ هذه المشكلة من عملية تحاول التشغيل في الخلفية عندما لا يتم تشغيل التطبيق بشكل نشط. ومع ذلك، نظرًا لإجراءات تحسين البطارية في Android، والتي تختلف عبر الإصدارات المختلفة، فقد لا يتم تشغيل هذه العملية في الخلفية بشكل صحيح. تم تصميم تحسين البطارية في Android للحد من نشاط التطبيقات في الخلفية للحفاظ على عمر البطارية، وهو ما قد يؤثر عن غير قصد على التطبيقات التي تتطلب عمليات خلفية للعمل بشكل صحيح.

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


الأسئلة الشائعة للمطورين

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

ابدأ مع SMSmobileAPI اليوم!

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

تنزيل التطبيق
💬 الدردشة المباشرة
💬 الدردشة المباشرة متاحة
هل لديك أي أسئلة أو تحتاج إلى مساعدة؟
فريقنا هنا لمساعدتك!

أدخل عنوان بريدك الإلكتروني
لمساعدتنا في متابعة طلبك:
لوحة القيادة