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

API حسابات WhatsApp

API عرض حسابات WhatsApp

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

POSThttps://wbiztool.com/api/v1/whatsapp/accounts/

النص (Body): JSON أو حقول نموذج

الفرقعرض الحساباتعرض الأرقام المتصلة
يتضمن الأرقام غير المتصلة والمحذوفةنعملا
مفاتيح كل عنصرwhatsapp_client_id، whatsapp_number، statusid، 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"
  }'

استبدل 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
}
الحقلالنوعالوصف
statusinteger‏1 عند النجاح، و0 إذا فشل الطلب.
whatsapp_clientsarrayكل رقم WhatsApp أُضيف إلى مساحة العمل هذه في أي وقت. يظهر عند النجاح فقط.
whatsapp_clients[].whatsapp_client_idintegerمعرّف الرقم. مرّره كقيمة whatsapp_client في استدعاءات API الأخرى.
whatsapp_clients[].whatsapp_numberstringرقم الهاتف كما حُفظ عند إضافته.
whatsapp_clients[].statusstring‏connected أو not_connected.

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

لا تحتوي الاستجابة الناجحة على الحقل message، لذا اقرأه مع قيمة احتياطية كما في الأمثلة.

الأخطاء#

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

إذا واجه الخادم مشكلة غير متوقعة، أو لم يكن الطلب POST، فستكون الاستجابة كائنًا فارغًا: {}. اعتبر غياب status فشلًا.

نصائح#

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