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

البدء

API التحقق من بيانات الاعتماد

استخدم هذا API للتحقق من بيانات الاعتماد قبل إجراء استدعاءات API أخرى. فهو يؤكد أن client_id وapi_key يعملان معًا، ويمكنه أيضًا التأكد من أن معرّف رقم WhatsApp ينتمي إلى مساحة العمل الخاصة بك. لا يرسل أي شيء ولا يستهلك أي رصيد.

POSThttps://wbiztool.com/api/v1/me/

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

مثال سريع#

curl -X POST https://wbiztool.com/api/v1/me/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'

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

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

client_idintegerمطلوب

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

api_keystringمطلوب

مفتاح API الخاص بك من الصفحة نفسها.

whatsapp_clientintegerاختياري

معرّف أحد أرقام WhatsApp الخاصة بك، من إعدادات WhatsApp. أرسله للتحقق أيضًا من أن المعرّف ينتمي إلى مساحة العمل الخاصة بمفتاح API هذا. الرقم الذي حذفته من لوحة التحكم يجتاز هذا الفحص أيضًا. فهو يتحقق من المعرّف فقط، ولا يخبرك ما إذا كان الرقم متصلًا. استخدم حالة الاتصال لذلك.

الاستجابة#

يُرجع الطلب الناجح HTTP 200:

{
  "status": 1,
  "message": "Okay",
  "name": "[email protected] - 919876543210"
}
الحقلالنوعالوصف
statusinteger‏1 إذا كانت بيانات الاعتماد صالحة، و0 إذا لم تكن كذلك.
messagestring‏Okay عند النجاح، وإلا نص الخطأ.
namestringاسم المستخدم للشخص الذي أنشأ مساحة العمل. إذا أرسلت whatsapp_client، يُضاف رقم هاتف ذلك الرقم بعد -. يظهر عند النجاح فقط.

الأخطاء#

كل حالة فشل في نقطة النهاية هذه تُرجع HTTP 400، باستثناء client_id غير الرقمي الذي يُرجع HTTP 403. ويحتوي الجسم دائمًا على status بقيمة 0:

{ "status": 0, "message": "Auth Error: invalid api key" }
الرسالةطريقة الإصلاح
Auth Errorأرسل client_id وapi_key كليهما في جسم طلب POST، بصيغة JSON صالحة أو كحقول نموذج. تظهر هذه الرسالة أيضًا عندما لا يكون whatsapp_client رقمًا.
Invalid Client Idأرسل client_id كعدد صحيح، مثل 12345.
Auth Error: invalid api keyتأكد من أن المفتاح موجود، ولم يُحذف، وينتمي إلى client_id هذا.
Invalid WhatsApp Client IDمعرّف whatsapp_client هذا غير موجود في مساحة العمل الخاصة بمفتاح API هذا. انسخ المعرّف من إعدادات WhatsApp.

التحقق من أن API يعمل#

‏/api/v1/status/ فحص تشغيل بسيط. لا يحتاج إلى بيانات اعتماد، ويقبل أي طريقة، ويُرجع دائمًا:

{ "status": 200, "data": {} }

يخبرك فقط بأن API قابل للوصول. ولا يتحقق من بيانات الاعتماد أو من اتصال رقم WhatsApp الخاص بك.

curl https://wbiztool.com/api/v1/status/

تستدعي الدالة health_check() في مكتبة Python نقطة النهاية هذه.

نصائح#

  • تحقّق مرة واحدة عند الإعداد: استدعِ نقطة النهاية هذه عندما يحفظ المستخدم بيانات اعتماده في تطبيقك، بدلًا من استدعائها قبل كل رسالة. نجاح الفحص لا يعني أنك تستطيع الإرسال: فهو لا ينظر إلى رصيدك المتبقي ولا إلى اتصال رقمك.
  • اقرأ الجسم عند الأخطاء: تعود حالات الفشل برمز HTTP 400 أو 403، لذا تأكد من أن عميل HTTP لديك يحلّل جسم JSON رغم ذلك.
  • تتوقف المفاتيح المحذوفة عن العمل فورًا: إذا حُذف مفتاح من صفحة مفاتيح API، فستحصل على Auth Error: invalid api key.
  • الخطوة التالية: بعد أن تعمل بيانات الاعتماد، أرسل رسالة.