Send WhatsApp API
تدعم واجهة برمجة تطبيقات SMSMobile طريقتين للمصادقة: استخدام مفتاح API بسيط أو بروتوكول OAuth2 مع معرف العميل وسر العميل.
1. مصادقة مفتاح API لإرسال الرسائل القصيرة
تتطلب هذه الطريقة مفتاح API يمكن تضمينه كمعلمة في طلب GET أو POST. إنها طريقة مباشرة للتحقق من صحة طلبات API الخاصة بك.
https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND
حدود:
- apikey:مفتاح API الفريد الخاص بك.
- recipients: The recipient's phone number (The number must be available on WhatsApp).
- message: The message to send (Multiple lines possible).
- waonly: must have the value yes -> Required to specify that only one WhatsApp message should be sent
مثال:
GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEYY&waonly=yes&recipients=+1234567890&message=Hello%20World
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?waonly=yes \
-H "التفويض: الناقل abc123xyz456" \
-H "نوع المحتوى: application/x-www-form-urlencoded" \
-d "المستلمون=+1234567890" \
-d "الرسالة=مرحبا"
ما هي الطريقة التي يجب عليك استخدامها؟
- يستخدم مصادقة مفتاح API للتكامل السريع والمباشر.
- يستخدم مصادقة OAuth2 لتعزيز الأمان وقابلية التوسع في عمليات التكامل الخاصة بك.
لمزيد من التفاصيل، يرجى الرجوع إلى الوثائق الكاملة.
Send WhatsApp message
عنوان URL لـ WSDL
https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl
حدود:
- recipients: The mobile number of the recipient.
- message: The message to send.
- apikey: The API key you have or will receive.
- waonly: must have the value yes -> Required to specify that only one WhatsApp message should be sent.
مثال
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("waonly" =>"yes","recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));
print_r($result);
Send WhatsApp
أمر cURL الأساسي
You can use the following cURL command to send a WhatsApp message via the SMSmobileAPI:
curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \
-d "recipients=PHONE_NUMBER" \
-d "message=YOUR_MESSAGE" \
-d "apikey=YOUR_API_KEY"
مثال cURL في PHP
If you're using PHP, here's how you can send an WhatsApp message using cURL:
<?php
$url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';
$data = array(
'recipients' => 'PHONE_NUMBER',
'message' => 'YOUR_MESSAGE',
'apikey' => 'YOUR_API_KEY'
);
$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، وتمرير المعلمات الضرورية كمصفوفة ارتباطية.
Send WhatsApp
استخدم وحدة Python الرسمية الخاصة بنا: https://smsmobileapi.com/python/ أو استخدم الطريقة اليدوية ...
استخدام مكتبة `requests`
The `requests` library is a popular and simple HTTP library for Python. Here's how you can use it to send an WhatsApp message via the SMSmobileAPI:
import requests
url = "https://api.smsmobileapi.com/sendsms/waonly=yes"
payload = {
"recipients": "PHONE_NUMBER",
"message": "YOUR_MESSAGE",
"apikey": "YOUR_API_KEY"
}
response = requests.post(url, data=payload)
print(response.text)
This example demonstrates a simple POST request to the SMSmobileAPI, sending a WhatsApp message to a specific phone number.
استخدام مكتبة `http.client`
تعتبر المكتبة `http.client` مضمنة في مكتبة Python القياسية ويمكن أيضًا استخدامها للتفاعل مع واجهة برمجة التطبيقات الخاصة بك:
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/?waonly=yes", params, headers)
response = conn.getresponse()
data = response.read()
print(data.decode("utf-8"))
conn.close()
يوضح هذا المثال كيفية استخدام مكتبة `http.client` لإرسال طلب POST إلى واجهة برمجة التطبيقات. يتم ترميز المعلمات بصيغة URL وإرسالها مع الرؤوس المناسبة.
Send WhatsApp
استخدام واجهة برمجة التطبيقات `fetch`
The `fetch` API is a modern and versatile way to make HTTP requests in JavaScript. Here's how you can use it to send a WhatsApp message via the SMSmobileAPI:
const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";
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));
يوضح هذا المثال كيفية إرسال طلب POST باستخدام واجهة برمجة التطبيقات `fetch`، والتي تدعمها معظم المتصفحات الحديثة.
استخدام `XMLHttpRequest`
إذا كنت بحاجة إلى دعم المتصفحات القديمة، فيمكنك استخدام الكائن `XMLHttpRequest`:
const xhr = new XMLHttpRequest();
const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";
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);
يوضح هذا المثال كيفية استخدام `XMLHttpRequest` لإرسال طلب POST، مما يوفر التوافق مع المتصفحات القديمة التي قد لا تدعم `fetch`.
Send WhatsApp
استخدام مكتبة `axios`
The `axios` library is a popular HTTP client for Node.js. Here's how you can use it to send a WhatsApp message via the SMSmobileAPI:
const axios = require('axios');
const url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';
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);
});
يوضح هذا المثال كيفية إرسال طلب POST باستخدام `axios` في Node.js للتفاعل مع SMSmobileAPI.
Send WhatsApp
استخدام مكتبة `Net::HTTP`
You can use the `Net::HTTP` library in Ruby to send a WhatsApp message via the SMSmobileAPI:
require 'net/http'
require 'uri'
uri = URI.parse("https://api.smsmobileapi.com/sendsms/?waonly=yes")
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
يوضح هذا المثال كيفية إرسال طلب POST باستخدام `Net::HTTP` في Ruby إلى SMSmobileAPI.