API حسابات WhatsApp
API عرض حسابات WhatsApp
استخدم هذا API للحصول على قائمة كاملة بكل أرقام WhatsApp الخاصة بك وحالة اتصالها، في استدعاء واحد. وعلى عكس عرض الأرقام المتصلة، فهو يتضمن الأرقام غير المتصلة.
https://wbiztool.com/api/v1/whatsapp/accounts/النص (Body): JSON أو حقول نموذج
| الفرق | عرض الحسابات | عرض الأرقام المتصلة |
|---|---|---|
| يتضمن الأرقام غير المتصلة والمحذوفة | نعم | لا |
| مفاتيح كل عنصر | whatsapp_client_id، whatsapp_number، status | id، whatsapp_client_id، whatsapp_client_number، is_connected |
message عند النجاح | غير موجود | okay |
مثال سريع#
curl -X POST https://wbiztool.com/api/v1/whatsapp/accounts/ \
-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/accounts/",
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 account in result["whatsapp_clients"]:
print(account["whatsapp_client_id"], account["whatsapp_number"], account["status"])
else:
print("Failed:", result.get("message", "no response"))// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/whatsapp/accounts/", {
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 account of result.whatsapp_clients) {
console.log(account.whatsapp_client_id, account.whatsapp_number, account.status);
}
} else {
console.error("Failed:", result.message ?? "no response");
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp/accounts/');
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 $account) {
echo $account['whatsapp_client_id'] . ' ' . $account['whatsapp_number'] . ' ' . $account['status'] . 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 الخاص بك من الصفحة نفسها. تخص القائمة مساحة العمل التي أُنشئ فيها هذا المفتاح.
الاستجابة#
يُرجع الطلب الناجح HTTP 200:
{
"whatsapp_clients": [
{
"whatsapp_client_id": 678,
"whatsapp_number": "919876543210",
"status": "connected"
},
{
"whatsapp_client_id": 702,
"whatsapp_number": "919812345678",
"status": "not_connected"
}
],
"status": 1
}
| الحقل | النوع | الوصف |
|---|---|---|
status | integer | 1 عند النجاح، و0 إذا فشل الطلب. |
whatsapp_clients | array | كل رقم WhatsApp أُضيف إلى مساحة العمل هذه في أي وقت. يظهر عند النجاح فقط. |
whatsapp_clients[].whatsapp_client_id | integer | معرّف الرقم. مرّره كقيمة whatsapp_client في استدعاءات API الأخرى. |
whatsapp_clients[].whatsapp_number | string | رقم الهاتف كما حُفظ عند إضافته. |
whatsapp_clients[].status | string | connected أو not_connected. |
لا تُرتَّب القائمة بأي ترتيب مضمون. رتّبها حسب whatsapp_client_id إذا كان الترتيب مهمًا.
لا تحتوي الاستجابة الناجحة على الحقل message، لذا اقرأه مع قيمة احتياطية كما في الأمثلة.
الأخطاء#
| الرسالة | 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، فستكون الاستجابة كائنًا فارغًا: {}. اعتبر غياب status فشلًا.
نصائح#
- إعادة ربط رقم: يمكن إعادة ربط الرقم الذي حالته
not_connectedمن إعدادات WhatsApp أو باستخدام ربط رقم. - رقم واحد فقط: للتحقق من رقم واحد، استخدم حالة الاتصال.
- عدة مساحات عمل: مفتاح API هو الذي يحدّد مساحة العمل التي تُعرض. استخدم مفتاحًا أُنشئ في مساحة العمل التي تريدها.
