WhatsApp अकाउंट API
WhatsApp अकाउंट की सूची API
एक ही कॉल में अपने सभी WhatsApp नंबरों और उनके कनेक्शन स्टेटस की पूरी सूची पाने के लिए इस API का इस्तेमाल करें। कनेक्टेड नंबरों की सूची के उलट, इसमें डिसकनेक्ट हुए नंबर भी शामिल होते हैं।
https://wbiztool.com/api/v1/whatsapp/accounts/बॉडी: JSON या फॉर्म फील्ड
| अंतर | अकाउंट की सूची | कनेक्टेड नंबरों की सूची |
|---|---|---|
| डिसकनेक्ट और डिलीट किए गए नंबर शामिल | हां | नहीं |
| आइटम की keys | 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 Keys से आपका API क्लाइंट ID।
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 | नंबर का ID। दूसरे API कॉल में इसे whatsapp_client के रूप में पास करें। |
whatsapp_clients[].whatsapp_number | string | फोन नंबर, जैसा वह जोड़ते समय सेव हुआ था। |
whatsapp_clients[].status | string | connected या not_connected। |
सूची किसी तय क्रम में नहीं होती। अगर क्रम मायने रखता है, तो whatsapp_client_id से सॉर्ट करें।
सफल रिस्पॉन्स में message फील्ड नहीं होता, इसलिए उदाहरणों की तरह इसे डिफ़ॉल्ट वैल्यू (fallback) के साथ पढ़ें।
एरर#
| संदेश | 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 की से तय होता है कि किस वर्कस्पेस की सूची मिलेगी। उसी वर्कस्पेस में बनाई गई की इस्तेमाल करें जो आपको चाहिए।
