API حسابات WhatsApp
API عرض أرقام WhatsApp المتصلة
احصل على أرقام WhatsApp في مساحة العمل الخاصة بك المتصلة الآن. استخدمه لتتيح للمستخدمين اختيار الرقم الذي يرسلون منه، أو لمعرفة معرّف whatsapp_client لاستدعاءات API الأخرى.
https://wbiztool.com/api/v1/whatsapp-client/list/النص (Body): JSON أو حقول نموذج
تُرجَع الأرقام المتصلة فقط. لرؤية الأرقام غير المتصلة أيضًا، استخدم عرض الحسابات.
مثال سريع#
curl -X POST https://wbiztool.com/api/v1/whatsapp-client/list/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY"
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/whatsapp-client/list/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
},
timeout=30,
)
result = response.json() # read the body even when the HTTP code is 400 or 403
if result.get("status") == 1:
for number in result["whatsapp_clients"]:
print(number["whatsapp_client_id"], number["whatsapp_client_number"])
else:
print("Failed:", result.get("message"))// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/whatsapp-client/list/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_id: 12345,
api_key: "YOUR_API_KEY",
}),
});
const result = await response.json(); // read the body even when the HTTP code is 400 or 403
if (result.status === 1) {
for (const number of result.whatsapp_clients) {
console.log(number.whatsapp_client_id, number.whatsapp_client_number);
}
} else {
console.error("Failed:", result.message);
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp-client/list/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if (($result['status'] ?? 0) === 1) {
foreach ($result['whatsapp_clients'] as $number) {
echo $number['whatsapp_client_id'] . ' ' . $number['whatsapp_client_number'] . PHP_EOL;
}
} else {
echo 'Failed: ' . ($result['message'] ?? 'no response');
}استبدل 12345 وYOUR_API_KEY بقيمك الخاصة. راجع المصادقة لمعرفة مكان العثور عليها.
معاملات الطلب#
client_idintegerمطلوبمعرّف العميل في API (API Client ID) من Settings → API keys (الإعدادات ← مفاتيح API).
api_keystringمطلوبمفتاح API الخاص بك من الصفحة نفسها. تخص القائمة مساحة العمل التي أُنشئ فيها هذا المفتاح.
استخدام مكتبات العملاء الرسمية#
تستدعي مكتبة Python نقطة النهاية هذه نيابةً عنك.
from wbiztool_client import WbizToolClient
client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)
result = client.list_whatsapp_clients()
for number in result.get("whatsapp_clients", []):
print(number["whatsapp_client_id"], number["whatsapp_client_number"])تُطلق مكتبة Python الاستثناء requests.exceptions.HTTPError عندما يُرجع API رمز HTTP 400 أو 403، لذا ضع الاستدعاء داخل try/except.
تستدعي الدالة getWhatsAppClients() في مكتبة Node.js عنوانًا غير موجود، فتفشل بالخطأ 404. استخدم fetch كما في المثال السريع.
الاستجابة#
يُرجع الطلب الناجح HTTP 200:
{
"message": "okay",
"whatsapp_clients": [
{
"id": 678,
"whatsapp_client_id": 678,
"whatsapp_client_number": "919876543210",
"is_connected": true
}
],
"status": 1
}
| الحقل | النوع | الوصف |
|---|---|---|
status | integer | 1 عند النجاح، و0 إذا فشل الطلب. |
message | string | okay عند النجاح، وإلا نص الخطأ. |
whatsapp_clients | array | أرقامك المتصلة. تكون فارغة إذا لم يكن أي رقم متصلًا. تظهر عند النجاح فقط. |
whatsapp_clients[].whatsapp_client_id | integer | معرّف الرقم. مرّره كقيمة whatsapp_client في استدعاءات API الأخرى. |
whatsapp_clients[].id | integer | القيمة نفسها الموجودة في whatsapp_client_id. |
whatsapp_clients[].whatsapp_client_number | string | رقم الهاتف كما حُفظ عند إضافة الرقم. |
whatsapp_clients[].is_connected | boolean | دائمًا true، لأن القائمة لا تتضمن إلا الأرقام المتصلة. |
لا تُرتَّب القائمة بأي ترتيب مضمون. رتّبها حسب whatsapp_client_id إذا كان الترتيب مهمًا.
الأخطاء#
| الرسالة | HTTP | طريقة الإصلاح |
|---|---|---|
Auth Error | 200 | أرسل client_id وapi_key كليهما في جسم طلب POST، بصيغة JSON صالحة أو كحقول نموذج. |
Invalid Client Id | 403 | أرسل client_id كعدد صحيح، مثل 12345. |
Auth Error: invalid api key | 400 | تأكد من أن المفتاح موجود، ولم يُحذف، وينتمي إلى client_id هذا. |
الطلب الذي ليس POST يُرجع كائنًا فارغًا {}. وعند حدوث مشكلة غير متوقعة في الخادم، يُرجع HTTP 500 مع جسم بصيغة HTML، لذا تحقّق من أن الاستجابة بصيغة JSON قبل قراءة status.
نصائح#
- قائمة فارغة: تعني
"whatsapp_clients": []أنه لا يوجد رقم متصل في مساحة العمل هذه. اربط رقمًا من إعدادات WhatsApp أو باستخدام ربط رقم. - عدة مساحات عمل: مفتاح API هو الذي يحدّد مساحة العمل التي تُعرض. استخدم مفتاحًا أُنشئ في مساحة العمل التي تريدها.
- رقم واحد فقط: للتحقق من رقم واحد، استخدم حالة الاتصال.
