البدء
API التحقق من بيانات الاعتماد
استخدم هذا API للتحقق من بيانات الاعتماد قبل إجراء استدعاءات API أخرى. فهو يؤكد أن client_id وapi_key يعملان معًا، ويمكنه أيضًا التأكد من أن معرّف رقم WhatsApp ينتمي إلى مساحة العمل الخاصة بك. لا يرسل أي شيء ولا يستهلك أي رصيد.
https://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
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/me/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 678,
},
timeout=30,
)
result = response.json() # read the body even when the HTTP code is 400 or 403
if result["status"] == 1:
print("Credentials OK for", result["name"])
else:
print("Failed:", result["message"])// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/me/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_id: 12345,
api_key: "YOUR_API_KEY",
whatsapp_client: 678,
}),
});
const result = await response.json(); // read the body even when the HTTP code is 400 or 403
if (result.status === 1) {
console.log("Credentials OK for", result.name);
} else {
console.error("Failed:", result.message);
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
'whatsapp_client' => 678,
];
$ch = curl_init('https://wbiztool.com/api/v1/me/');
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) {
echo 'Credentials OK for ' . $result['name'];
} else {
echo 'Failed: ' . ($result['message'] ?? 'no response');
}استبدل 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"
}
| الحقل | النوع | الوصف |
|---|---|---|
status | integer | 1 إذا كانت بيانات الاعتماد صالحة، و0 إذا لم تكن كذلك. |
message | string | Okay عند النجاح، وإلا نص الخطأ. |
name | string | اسم المستخدم للشخص الذي أنشأ مساحة العمل. إذا أرسلت 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. - الخطوة التالية: بعد أن تعمل بيانات الاعتماد، أرسل رسالة.
