انتقل إلى المحتوى
Wbiztool

API حسابات WhatsApp

API عرض أرقام WhatsApp المتصلة

احصل على أرقام WhatsApp في مساحة العمل الخاصة بك المتصلة الآن. استخدمه لتتيح للمستخدمين اختيار الرقم الذي يرسلون منه، أو لمعرفة معرّف whatsapp_client لاستدعاءات API الأخرى.

POSThttps://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"
  }'

استبدل 12345 وYOUR_API_KEY بقيمك الخاصة. راجع المصادقة لمعرفة مكان العثور عليها.

معاملات الطلب#

client_idintegerمطلوب

معرّف العميل في API ‏(API Client ID) من Settings → API keys (الإعدادات ← مفاتيح API).

api_keystringمطلوب

مفتاح API الخاص بك من الصفحة نفسها. تخص القائمة مساحة العمل التي أُنشئ فيها هذا المفتاح.

استخدام مكتبات العملاء الرسمية#

تستدعي مكتبة Python نقطة النهاية هذه نيابةً عنك.

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
}
الحقلالنوعالوصف
statusinteger‏1 عند النجاح، و0 إذا فشل الطلب.
messagestring‏okay عند النجاح، وإلا نص الخطأ.
whatsapp_clientsarrayأرقامك المتصلة. تكون فارغة إذا لم يكن أي رقم متصلًا. تظهر عند النجاح فقط.
whatsapp_clients[].whatsapp_client_idintegerمعرّف الرقم. مرّره كقيمة whatsapp_client في استدعاءات API الأخرى.
whatsapp_clients[].idintegerالقيمة نفسها الموجودة في whatsapp_client_id.
whatsapp_clients[].whatsapp_client_numberstringرقم الهاتف كما حُفظ عند إضافة الرقم.
whatsapp_clients[].is_connectedbooleanدائمًا true، لأن القائمة لا تتضمن إلا الأرقام المتصلة.

لا تُرتَّب القائمة بأي ترتيب مضمون. رتّبها حسب whatsapp_client_id إذا كان الترتيب مهمًا.

الأخطاء#

الرسالةHTTPطريقة الإصلاح
Auth Error200أرسل client_id وapi_key كليهما في جسم طلب POST، بصيغة JSON صالحة أو كحقول نموذج.
Invalid Client Id403أرسل client_id كعدد صحيح، مثل 12345.
Auth Error: invalid api key400تأكد من أن المفتاح موجود، ولم يُحذف، وينتمي إلى client_id هذا.

الطلب الذي ليس POST يُرجع كائنًا فارغًا {}. وعند حدوث مشكلة غير متوقعة في الخادم، يُرجع HTTP 500 مع جسم بصيغة HTML، لذا تحقّق من أن الاستجابة بصيغة JSON قبل قراءة status.

نصائح#

  • قائمة فارغة: تعني "whatsapp_clients": [] أنه لا يوجد رقم متصل في مساحة العمل هذه. اربط رقمًا من إعدادات WhatsApp أو باستخدام ربط رقم.
  • عدة مساحات عمل: مفتاح API هو الذي يحدّد مساحة العمل التي تُعرض. استخدم مفتاحًا أُنشئ في مساحة العمل التي تريدها.
  • رقم واحد فقط: للتحقق من رقم واحد، استخدم حالة الاتصال.